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CHAPTER 1 

GENERAL INFORMATION ABOUT MSX BASIC 


MSX BASIC is an extended version to the Microsoft standard Basic version 

M^'u deS SU ^ P = r + S + ° graphics, music and various peripherals 
a, tached to MSX Home and Personal computer. Generally, MSX BASIC is 

esigned to follow the GW-BASIC which is a standard Basic in 16-bit 
machine.world. But the major effort was made to make the whole system 
as flexible and expandable as possible. 

A1S0 . MSX * ASlC Is featured with up to 14 dicits accuracy double 
precision BCD arithmetic function. This means arithmetic operations 
no more generate strange round errors that confuse novice users. Every 
trancendentaI functions are also calculated with this accuracy. 16 
1 signe Integer operation is also available for faster execution. 


1 . 1 MODES OF OPERATION 

When MSX BASIC is initialized, it displays the prompt "Ok". "Ok" 
indicates MSX BASIC is at command level; that is, it is ready to accept 
commands. At this point, MSX BASIC may be used in either of two modes: 
direct mode or indirect mode. 

In direct mode, MSX BASIC statements and commands are not preceded 
by I i ne numbers. They are executed as they are entered. Results of 
arithmetic and logical operations may be displayed immediately and 
stored for later use. but the Instructions themselves are lost after 
execution. Direct mode is useful for debugging and for using MSX BASIC 

as a "calculator" for quick computations that do not require a complete 
program. ^ 

Indirect mode is used for entering programs. Program lines: are preceded 
by line numbers and are stored in memory. The program stored in memory 
is executed by entering the RUN command. 


1.2 LINE FORMAT 
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MSX BASIC program lines have the following format (square brackets 
indicate optional input): 

nnnnn BASIC statementC :BAS IC statement...]] <carriage return> 

More than one BASIC statement may be placed on a line, but each must 
be separated from the last by a colon. 

An MSX BASIC program line always begins with a line number and ends 
with a carriage return. A line may contain a maximum of 255 characters. 



1.2.1 Line Numbers 

Every MSX BASIC program line begins with a line number. Line numbers 
indicate the order in which the program lines are stored In memory. 
Line numbers are also used as references in branching and editing. 
Line numbers must be in the range 0 to 65529. 

A period (.) may be used in LIST, AUTO. and DELETE 
commands to refer to the current line. 


1 .3 CHARACTER SET 

The MSX BASIC character set consists of alphabetic characters, numeric 
characters, special characters ,graphic characters and both hirakana 
and katakana characters. 

The alphabetic characters in MSX BASIC are the upper case and lower 
case letters of the alphabet. 

The MSX BASIC numeric characters are the digits 0 through 9. 

In addition, the following special characters are recognized by MSX 
BAS 1C: 


Character 


* 

/ 

A 

( 

) 

% 

# 

S 

I 

C 


Action 

Blank 

Equals sign or assignment symbol 
Plus sign 
Mi nus sign 

Asterisk or multiplication symbol 

Slash or division symbol 

Up arrow or exponentiation symbol 

Left parenthesis 

Right parenthesis 

Percent 

Number (or pound) sign 
Dollar sign 
Exclamation point 
Left bracket 
Right bracket 
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P 

I 

P 


& 

? 

< 

> 

¥ 

§ 

<rubou+> 
<escaoe> 

<ta b > 

< I I ne feed> 
<carr i age 
return> 


Comma 

Period or decimal point 

Single quotation mark (apostrophe) 

Semicolon 

Co I on 

Ampersand 

Question mark 

Less than 

Greater than 

Yen sign or integer division symbol 

At sign 

Underscore 

Deletes last character typed. 

Escapes 

Moves print position to next tab stop. 
Tab stops are set every eight columns. 
Moves to next physical line. 

Terminates input of a line. 


1.4 CONSTANTS 

Constants are the values MSX BASIC uses during execution. There are 
two types of constants: string and numeric. 

A string constant is a sequence of up to 255 alphanumeric characters 
enclosed In double quotation marks. 

Examples: 


"HELLO" 

"525,000.00 " 

"Number of Employees" 


Numeric constants are positive or negative numbers. MSX BASIC numeric 
constants cannot contain commas. There are five types of numeric 
constants: 


1. Integer constants 

2. Fixed-point 
constants 


Whole numbers between -32768 and 32767. Integer 
constants do not contain decimal points. 

Positive or negative real numbers, i.e., numbers 
that contain decimal points. 


3. Floating-point Positive or negative numbers represented in 
constants exponential form (similar to scientific 

nofation). A floating-point constant consists 
of an optionally signed integer or fixed-point 
number (the mantissa) followed by the letter 
E and an optionally signed tnteger (the 
exponent). The allowable range for 
floating-point constants is 10-64 to 10+63. 


Examp Ies: 
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235.988E-7 = .0000235988 
2359E6 =2359000000 

(Double precision floating-point constants 
are denoted by the letter D instead of E.) 


4. Hex constants Hexadecimal numbers, denoted by the prefix 

4H. 

Examples: 


4H76 

4H32F 

5. Octal constants Octal numbers, denoted by the prefix 40 or 4. 

Exam pies: 

40347 

41234 

6. Binary constants Binary numbers, denoted by the prefix 4B. 

Examples: 

4B01110110 
4B111001 1 1 



1.4.1 Single And Double Precision Form For Numeric Constants 

Numeric constants may be either single precision or double precision 
numbers. Single precision numeric constants are stored with 6 digits 
of precision, and printed with up to 6 digits of precision. Double 
precision numeric constants are stored with 14 digits of precision 
and printed with up to 14 digits. Double precision Is the default 
for constant in MSX BASIC. 

A single precision constant is any numeric constant that has one of 
the following characteristics: 

1. Exponential form using E. 

2. A trailing exclamation point (I). 

Examples: 

-1.09E-06 

22.5! 

A double precision constant Is any numeric constant that has one of 
these characteristics: 
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1. Any digits of number without any exponential or type specifier. 

2. Exponential form using D.' 

3. A trailing number sign (#). 

Examp Ies: 

3489 

345692811 
-1.0943 2D-06 
3489.0# 

7654321 . 1234 


1.5 VARIABLES 

Variables are names used to represent values used in a BASIC program. 
The value of a variable may be assigned explicitly by the programmer, 
or it may be assigned as the result of calculations in the program. 
‘3efore a variable Is assigned a value, its value Is assumed to be zero. 


1.5.1 Variable Names And Declaration Characters 

MSX BASIC variable names may be any length. Up to 2 characters are 
significant. Variable names can contain letters and numbers. However, 
the first character must be a letter. Special type declaration 
characters are also allowed—see below. 


A variable name may not be a reserved word and may not contain embedded 
reserved words. Reserved words include all MSX BASIC commands, 
statements, function names, and operator names. If a variable begins 
with FN, it is assumed to be a call to a user-defined function. 

Variables may represent either a numeric value or a string. String 
variable names are written with a dollar sign ($) as the last character. 
For example: AS = "SALES REPORT". 

The dollar sign is a variable type declaration character; that is, 
it "declares" that the variable will represent a string. 


Numeric variable names may declare Integer, single precision, or double 
precision values. The type declaration characters for these variable 
names are as follows: 


w 

fi 

I 

# 

The default 
Examp Ies of 


Integer variable 
Single precision variable 
Double precision variable 
type for a numeric variable name 
MSX BASIC variable names: 


Is doubIe precision. 
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PI f 

MINIMUM! 

LIMIT? 

N $ 

ABC 


Declares a double precision value. 
Declares a single precision value. 
Declares an integer value. 

Declares a string value. 

Represents a double precision value. 


There is a second method by which variable types may be declared. The 
MSX BASIC statements DEFINT, DEFSTR, DEFSNG, and DEFDBL may be Included 
in a program to declare the types for certain variable names. Refer 
to the description for these statements. 


1.5.2 Array Variables 

An array is a group or table of values referenced by the same variable 
name. Each element in an array Is referenced by an array variable 
that is subscripted with an Integer or an integer expression. An array 
variable name has as many subscripts as there are dimensions in the 
array. For example V(10) would reference a value in a one-dimension 
array, T(1,4) would reference a value In a two—dimension array, and 
so on. The maximum number of dimensions for an array is 255. The 
maximum number of elements is determined by memory size. 

1.5.3 Space Requirements 


ihe following table lists only the number of bytes occupied by the 
values represented by the variable names. 


Variables 

Type 

Bytes 



1 nteger 

2 



Single Precision 

4 



Double Precision 

8 


Arrays 

Type 

Bytes 



1 nteger 

2 per 

e1ement 


Single PrecIsI on 

4 per 

e1ement 


Dou b1e Prec I s1 on 

8 per 

e1ement 


Strings 


3 bytes overhead plus the present contents of the string. 


1 .}6 TYPE CONVERSION 

When necessary, MSX BASIC will convert a numeric constant from one 

type to another. The following rules and examples should be kept In 
mind. 


^ * I f ;a numeric constant of one Type Is set equal to a numeric 
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variable of a different type, the number will be stored as 
the type declared In the variable name. (If a string variable 
is set equal to a numeric value or vice versa, a "Type mismatch" 
error occurs.) 

Examp Ie: 

10 A$ =23.42 
20'PR I NT A% 

RUN 

23 

2. During expression evaluation, all of the operands in an 
arithmetic or relational operation are converted to the same 
degree of precision, i.e., that of the most precise operand. 
Also, the result of an arithmetic operation is returned to 
this degree of precision. 


Exam pies: 

The arithmetic was performed In double 
precision and the result was returned 
in D as a double precision value. 

The arithmetic was performed In double 
precision and the result was returned 
to D! (single precision variable), 
rounded, and printed as a single 
precIsion value. 

3. Logical operators convert their operands to Integers and return 
an integer result. Operands must be In the range -32768 to 
32767 or an "Overflow" error occurs. 

4. When a floating-point value is converted to an integer, the 
fractional portion is truncated. 

Example: 

10 C$ = 55.88 
20 PRINT C% 

RUN 

55 


10 D=6/71 
20 PRINT 0 
RUN 

. 8571428571 4286 

10 D!=6/7 
20 PRINT D! 

RUN 

.857143 


5. If a double precision variable Is assigned a single precision 
value, only the first six digits of the converted number will 
be valid. This is because only six digits of accuracy were 
supplied with the single precision value. 3 

Exam pie: 


10 A I = SQR(2) 
20 B=A! 

30 PR I NT;A!,B 
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RUN 

1.41421 1.41421 


1.7 EXPRESSIONS AND OPERATORS 

An expression may be a string or numeric constant, a variable, or a 
combination of constants and variables with operators which produces 
a single value. 

Operators perform mathematical or logical operations on values. The 
MSX BASIC operators may be divided into four categories: 


1. Arithmetic 

2. Relational 
3 . Logical 

4. Functional 


Each category is described in the following sections. 


1.7.1 Arithmetic Operators 

ihe arithmetic operators, in order of precedence, are: 


Operator 

A 


*,/ 


+ * “ 


OperatI on 

Exponentiation 

Negation 

Multiplication, Floating¬ 
point Division 

Addition, Subtraction 


Sample Expression 
X A Y 

-X 

X* Y 
X/Y 

X+Y 


To change the order in which the operations are performed, use 
parentheses. Operations within parentheses are performed first. Inside 
parentheses, the usual order of operations is maintained. 


1.7.1.1 Integer Division And Modulus Arithmetic 
Two additional operators are available in MSX BASIC: 

Integer division is denoted by the yen symbol. The operands are 
truncated to Integers (must be in the range -32768 to 32767) before 
the division is performed, and the quotient is truncated to an integer. 


Examp Ie: 
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10¥4=2 

25.68¥6.99=4 

Integer division follows multiplication and floating-point division 
In order of precedence. 

Modulus arithmetic Is denoted by the operator MOD. Modulus arithmetic 
yields ihe fnieger value that Is the remainder of an integer division. 

Example: 

10.4 MOD 4=2 (10/4=2 with a remainder 2) 

25.68 MOD 6.99=1 (25/6=4 with a remainder 1) 

Modulus arithmetic follows integer division in order of precedence. 

1.7.1.2 Overflow And Division By Zero - 

If, during the evaluation of an expression, division by zero is 
encountered, the ''Division by zero" error message is displayed and 
execution of program terminates. 

If overflow occurs, the "Overflow" error message is displayed and 
execution terminates. 


1.7.2 Relational Operators 

Relational operators are used to compare two values. The result of 
the comparison is either "true" (-1) or "false" (0). This result may 
then be used to make a decision regarding program flow. (See 
description for "IF" statements.) 

The relational operators are: 


Operator 

Re 1 at 1 on Tested 

Example 

= 

Equality 

X = Y 

<> 

1neq ua1 Ity 

X<> Y 

< 

Less than 

X< Y 

> 

Greater than 

X> Y 

< = 

Less than or equal to 

X 

A 

II 

-< 

> = 

Greater than or equal to 

X> = Y 


(The equal sign is also used to assign a value to a variable.) 

When arithmetic and relational operators are combined in one expression, 
the arithmetic is always performed first. For example, the expression 
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X+Y<(T-1}/Z 

is true if the value of X plus Y Is less than the value of T-l divided 

More examples: 

IF SINCXXO GOTO 1000 
IF' I MOD J<>0 THEN K=K + 1 


1.7.3 Logical Operators 


Logical operators perform tests on multiple relations bit manrnni*+t 
or Boolean operations. The logical opera'tor r e ,„ 'a'' | “ } 

Which ,s either "true" (not zero) or "false" (zero). In an exoressloi 

ooerat ons Per Th' 0nS + 3re perforrned after arithmetic and relational 

In Tab e ° UfC ° me of a 1 °9 f ca J operation Is determined as shown 

in Table 1. The operators are listed in order of precedence. 

Table 1. MSX BASIC Relational Operators Truth Table 


NOT 

X 

1 

0 

AND 

X 

1 

1 

0 

0 

OR 

X 

1 

1 

0 

0 

XOR 

X 

1 

1 

0 

0 

EQV 

X 

1 

1 

0 

0 


NOT X 
0 
1 


Y 

1 

0 

1 

0 


Y 

1 

0 

1 

0 


Y 

1 

0 

1 

0 


Y 

1 

0 

1 

0 


X AND Y 
1 
0 
0 
0 


X OR Y 
1 
1 
1 
0 


X XOR Y 
0 
1 
1 

0 


X EQV Y 
1 

0 
0 
1 


r 
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IMP 


X 

1 

1 

0 

0 


Y 

1 

0 

1 

0 


X IMP Y 
1 

0 

1 

1 


Just as the relational operators can be used to make decisions regarding 
program flow, logical operators can connect two or more relations and 
return a true or false value to be used in a decision . 


Example: 

IF D<200 AND F<4 THEN 80 
IF 1 >10 OR K<0 THEN 50 
IF NOT P THEN 100 


Logical operators work by converting their operands to 16-bit, signed, 
two's complement integers in the range -32768 to 32767. (If the 
operands are not in this range, an error results.) if both operands 
are supplied as 0 or -1 , logical operators return 0 or -1. The given 
operation is performed on these integers in bitwise fashion, i.e., 
each bit of the result is determined by the correspond i ng bits in the 
two operands. 


Thus, it is possible to use logical, operators to test bytes for a 
particular bit pattern. For instance, the AND operator may be used 
to "mask" alI but one of the bits of a status byte at a machine I/O 
port. The OR operator may be used to "merge" two bytes to create a 
particular binary value. The following examples will help demonstrate 
how the logical operators work. 

63 AND 16=16 63=binary 111111 and 16=binary 10000, so 63 AND 16=16. 


15 AND 14=14 

-1 AND 8=8 

4 OR 2=6 
10 OR 10=10 


15=binary 1111 and 14=binary 1110, so 15 AND 14=14 
(binary 1110). 

-1=binary 1111111111111111 and 8=binary 1000, so -1 
AND 8=8. 

4=binary 100 and 2=binary 10, so 4 OR 2=6 (binary 110). 
10 = binary 1010, so 1010 OR 1010= 1010 (decimal 10). 


-1 OR -2 = -1 -1=binary 1111111111111111 and -2 = binary 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 0 

so -1 OR -2=-1. The bit complement of sixteen zeros 
is sixteen ones, which is the two's complement 
representation of -l. 

NOT X=-(X+1) The two's complement of any Integer is the bit 

complement plus one. 


1.7.4 Functional Operators 








Language specification for MSX BASIC 


Page 13 


A function Is used In an expression to cal I a predeterm i ned operation 
that Is to be performed on an operand. MSX BASIC has "intrinsic" 
functions that reside In the system, such as SQR (square root) or SIN 
(sine). 

MSX BASIC also allows "user-defined" functions that are written by 
the programmer. See descriptions for "DBF FN". 


1.7.5 String Operations 

Strings may be concatenated by using +. 

Examp Ie: 


10 A $ ="FIL E" : B$="NAME" 

20 PRINT AS+BS 
30 PRINT "NEW "+A$+B$ 

RUN 

FILENAME 
NEW FILENAME 

Srrings may be compared using the same relational operators that are 
used with numbers: 

=<>•<><=>= 

String comparisons are made by taking one character at a time from 
each string and comparing the ASCII codes. If all the ASCII codes 
are the same, the strings are equal. If the ASCII codes differ, the 
lower code number precedes the higher. If during string comparison 
the end of one string is reached, the shorter string is said to be 
smaller. Leading and trailing blanks are significant. 

Examples: 

"AA"<"AB" 

"FILENAME"="FILENAME" 

"X&">"X#" 

"CL ">"CL" 

"kg">"KG" 

"SMYTH"<"SMYTHE" 

B$<"9/12/83" where B$ = "8/12/83" 

Thus, string comparisons can be used to test string values or to 
alphabetize strings. All string constants used In comparison 
expressions must be enclosed In quotation marks. 


1 .8 PROGRAM EDITING ' 

The Full Screen Editor equlped with MSX BASIC allows the user to enter 
program lines as usual, then edit an entire screen before recording 
the changes. This time-saving capability Is made possible by special 
keys for cursor movement, character Insertion and deletion, and line 
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or screen erasure. Specific functions and key assignments are discussed 
In the following sections. 

With the FulI Screen Editor, a user can move quickly around the screen, 
making corrections where necessary. The changes are entered by placing 
the cursor on the first line changed and pressing <RETURN> at the 
beginning of each line. A program line Is not actually changed until 
<RETURN> Is entered from somewhere within the line. 


Writing Programs 


Within MSX BASIC, the editor is in control any time after an OK prompt 
and before a RUN command Is issued. Any line of text that is entered 
is processed by the editor. Any line of text that begins with a number 
is considered a program statement-. 


Program statements are processed by the editor in one of the following 
ways : 


1. A new line is added to the program. This occurs if the line 
number is valid (0 through 65529) and at least one non-blank 
character follows the line number. 


2. An existing line is modified. This occurs if the line number 
matches that of an existing line in the program. The existing 
line Is replaced with the text of the new line. 


3. An existing line Is deleted. This occurs if the line number 
matches that of an existing line, and the new line contains 
only the line number. 


4. An error is produced. 

If an attempt is made to delete a non-existent line, an 
"Undefined line number" error message is displayed. 


If program memory is exhausted, and a line is added to the 
program, an "Out of memory" error is displayed and the line 
is not added. 


More than one statement may be placed on a line. If this is done, 
the statements must be separated by a colon (:). The colon does not 
have to be surrounded by spaces. 

The maximum number of characters allowed In a program line. Including 
the line number, is 250. 

Editing Programs 3 


Use the LIST statement to display an entire program or range of lines 
on the screen so that they can be edited. Text can then be modified 
by moving the cursor to the place where the change Is needed and 
performing one of the following actions: 


! 
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1. 

Typing over existing 

characters 




2. 

Deleting characters 

to 

the right 

of 

the 

cursor 

3 . 

Deleting characters 

to 

the left 

of 

th e 

cursor 

4 . 

inserting characters 






5 . 

Appending characters 

to 

the end 

of 

the 

logical 


These actions are performed by special keys assigned to the various 
Full Screen Editor functions (see next section). 

Changes to a line are recorded when a carriage return is entered while 
the cursor is somewhere on the line. The carriage return enters all 
changes for that logical line, no matter how many physical lines are 
included and no matter where the cursor is located on the line. 


Full Screen Editor Functions 

The following table lists the hexadecimal codes for the MSX BASIC 
control characters and summarizes their functions. The Control-key 
sequence normally assigned to each function is also listed. These 
conform as closely as possible to ASCII standard conversions. 

Individual control functions are described following the table. 


Table 1. MSX BASIC Control Functions. The ASCII control key is entered 
by pressing the key while holding down the Control key. 


Hex. 

Contro1 Special 


Code 

Key 

Key 

Function 

01 

A 


Graphic character header 

02 

B 


Move cursor to start of previous word 

03 

C 


Break when MSX BASIC is waiting for input 

04 

D 


1 gnored 

05 

E 


Truncate line (clear text to end of logical 
line) 

06 

F 


Move cursor to start of next word 

07 

G 


Beep 

08 

H 

Back Space 

Backspace, deleting characters passed over 

09 

1 

Tab 

Tab (8 spaces) 

0A 

J 


Line feed 

0B 

K 

Home 

Move cursor to home position 

OC 

L 

CIS 

Clear screen 

0D 

M 

Return 

Carriage return (enter current logical line) 

0E 

N 


Append to end of line 

OF 

0 


1 gnored 

10 

P 


1gnored 

1 1 

Q 


Ignored 

12 

R 

INS 

Toggle Insert/typeover mode 

13 

S 


Ignored 
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1 4 

T 


1 gnored 


15 

U 


Clear logical 

1 i ne 

1 6 

V 


Ignored 


17 

w 


1gnored 


18 

X 

SeIect 

1gnored 


1 9 

Y 


1gnored 


1 A 

z 


1 gnored 


1 B 

C 

ESC 

1 gnored 


1C 

\ 

Right arrow 

Cursor right 


1 D 

: 

Left arrow 

Cursor left 


1 E 

/\ 

Up arrow 

Cursor up 


1 F 


Down arrow 

Cursor down 


7F 

DEL 

DEL 

Delete character at 


PREVIOUS WORD 

The cursor Is moved left to the previous word. The previous 
word is defined as the next character to the left of the cursor 
in the sets A-Z, a-z, or 0-9. 

BREAK 

Returns to MSX BASIC direct mode, without saving changes that 
were made to the line currently being edited. 

TRUNCATE 

The cursor is moved to the end of the logical I i ne. The 
characTers it passes over are deleted. Characters typed, from 
the new cursor position are appended to the line. 

NEXT WORD 

The cursor is moved right to the next word. The next word 
is defined as the next character to the right of the cursor 
in the sets A-Z, a-z, or 0-9. 

BEEP 

The beep sound will be produced. 

BACKSPACE 

Deletes the character to the left of the cursor. All characters 
to the right of the cursor are moved left one position. 
Subsequent characters and lines within the current logical 
line are moved up (wrapped). 

TAB 

TAB moves the cursor to the next tab stop overwriting blanks. 
Tab stops occur every 8 characters. 

CURSOR HOME 

Moves the cursor to the upper left corner of the screen. The 
screen Is not blanked. 

CLEAR SCREEN 

Moves the cursor to home position and clears the entire screen, 
regardless of where the cursor is positioned when the key Is 
entered. 
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CARRIAGE RETURN 

A carriage return ends the logical line and sends it to MSX 
BASIC. 

APPEND 

Moves cursor to the end of the I Ine, without deleting the 
characters passed over. All characters typed from the new 
position until a carriage return are appended to the logical 
line. 

INSERT 

Toggle switch for insert mode. When insert mode is on, the 
size of the cursor is reduced and characters are inserted at 
the current cursor position. Characters to the right of the 
cursor move right as new ones are inserted. Line wrap is 

observed. 

When insert mode is off, the size of cursor returned to normal 
size and typed characters will replace existing characters 
on the line. 

CLEAR LOGICAL LINE 

When this key is entered anywhere in the line. the entire 
logical line is erased. 

CURSOR RIGHT 

Moves the cursor one position to the right. Line wrap .is 

observed. 

CURSOR LEFT 

Move the cursor one position to the left. Line wrap is 

observed. 

CURSOR UP 

Moves the cursor up one physical line Cat the current position). 
CURSOR DOWN 

Move the cursor down one physical Iine (at the current 

position). 


Logical line Definition with INPUT 

Normally, a logical Iine consists of alI the characters on each of 
the physical lines that make up the logical line. During execution 
an INPUT or LINE INPUT statement, however, this definition Is 
modified si ightly to al low for forms Input. When either of these 
statements is executed, the logical line is restricted to characters 
actually typed or passed over by the cursor. Insert mode and the delete 
function only move characters which are within that logical line, and 
Delete will decrement the size of the line. 

Insert mode Increments the logical line except when the characters 
moved will write over non-blank characters that are on the same physical 
line but not part of the logical line. In this case, the non-blank 
characters not part of the logical line are preserved and the characters 
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at the end of the logical Iine are thrown out. This preserves labels 
that existed prior to the INPUT statement. If an incorrect character 
is entered as a line is being typed. It can be deleted with the <Back 
Space> key or with Control-H. and they backspacing over a character 
and erasing it. Once a character(s) has been deleted, simply continue 
typing the line as desired. 

To delete a line that is in the process of being typed, type Control-U. 

To correct program lines for a program that is currently in memory, 
simply retype the line using the same line number. MSX BASIC will 
automatically replace the old line with the new line. 

To delete the entire program currently residing In memory, enter the 
NEW command. NEW is usually used to clear memory prior to entering 
a new program. 


1.9 Special keys 

. MSX BASIC supports several special keys as follows. 

1.9.1 Function Keys 

MSX BASIC has 10 pre—defined function keys. The current contents of 
these Keys are displayed on the last IIne on the screen and can be 
re-defined by program with KEY statement. The initial values for each 
keys are: 


FI 

co1orCbJ 

F2 

autoCbJ 

F 4 

gotoCbH 

F 5 

1IstCb] 

F5 

runCcrJ 

F6 

color 15,4 ,7CcrJ 

F7 

c 1 oa d " 

F 8 

contCcrH 

F 9 

1 1 st.Ccr3Cu3CuJ 

F1 0 

Cc1s]runCcr3 


[bH = bIank character 
Ccr3 = carriage return 
CuJ = cursor up character 
[cIs3= clear screen character 


Function keys are also used as event trap keys. See ON KEY GOSUB and 
KEY ON/OFF/STOP statement for details. 



1 .9.2 S top key 

When MSX BASIC is in command mode, the STOP key has no effects to the 
operation, MSX BASIC Just ignores It. 

When MSX BASIC Is executing the program, pressing the STOP key causes 
suspension of the program execution, and MSX BASIC turn on the cursor 
display to Indicate that the execution is suspended. Another STOP 
key input resumes the execution. If the STOP key and control key are 
pressed simultaneously, MSX BASIC terminates the execution and return 
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to command mode with following message. 

Break in nnnn 

where nnnn is the program line number where the execution' stopped. 
1.10 ERROR MESSAGES 


If an error causes program execution to terminate, an error message 
is printed. For a complete list of MSX BASIC error codes and error 
messages, see Appendix A. 
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CHAPTER 2 

MSX BASIC COMMANDS, STATEMENTS AND FUNCTIONS 


2.1 Commands, Statements, and Functions except I/O 

2.1.1 Commands except I/O 

AUTO C< Iine number >C, <Increment>j3 

To generate a line number automatically after every carriage 
retu rn . 

AUTO begins numbering at <Iine number> and increment each 
subsequent line number by <increment>. The default for both 
value is 10. If <line number> is followed by a comma but 
<!ncrement> is not specified, the last increment specified in 
an AUTO command is assumed. 

If AUTO generates a line number that is already being used, an 
asterisk is printed after the line number to warn the user that 
any Input will replace the existing line. However, typing a 
carriage return immediately after the asterisk will save the 
line and generate the next line number. 

AUTO is terminated by typing Control-C or ControI - STOP. The 
line in which Control-C is typed is not saved. After Control-C 
is typed, BASIC returns to command level. 

CONT 

To continue program execution after BREAK or STOP in execution. 

DELETE C < IIne number >3C -< I Ine number>3 
To delete program lines. 

BASIC always returns to command level after a DELETE Is executed. 
If < I i ne number> does not exist, an 'Illegal function call' error 
occurs. 

LIST C<l Ine number>C-C< I tne number>3H3 

To list all or part of the program. 
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If both <I Ine number> parameters are omitted, the program is 
listed beginning at the lowest line number. 

If only the first <I i n e number> is specified, that line Is listed. 

If the first <line number> and are specified, that line and 

all h i.gher-numbered lines are listed. 

If and the second < I I ne number> are specified, all lines 

from the beginning of the program through that line are listed. 

If both <Iine number> parameters are specified, the range from 
the first <1 ine number> through the second <1 Ine number> Is 
I I sted. 

Listing is terminated by typing "CTRL" and "STOP" keys at same 
time. Listing is suspended by typing "STOP" key. and it is 
resumed by typing "STOP" key again. 

LLIST I i ne number >C~C < I l ne number>331] 

To list all or part of the program on the printer. (See the 
LIST command for details of the parameters) 

NEW 

To delete entire program from working memory and reset all 
variables. 

RENUM CC < new number>3C,C < oId number>3C,<increment>33H 
To renumber program lines. 

<new number> Is the first line number to be used In the new 
sequence. The default is 10. <old number> is the line in the 
current program where renumbering Is to begin. The default is 
the first line of the program. <increment> Is the Increment 
to be used in the new sequence. The default Is 10. 

RENUM also changes all line number references following GOTO, 
GOSUB, THEN. ELSE. ON..GOTO, 0N..G0SUB and ERL statements to 
reflect the new line numbers. If a nonexistent line number 
appears after one of these statement, the error message ’Undefined 
line nnnn in mmmm' is printed. The Incorrect line number 
reference(nnnn) Is not changed by RENUM, but line number mmmm 
may be changed. 

NOTE: RENUM cannot be used to change the order of program lines 
(for example, RENUM 15,30 when the program has three lines 
numbered 10, 20 and 30). or to create line numbers greater than 
65529. An 'Illegal function call' error will result. 

RUN C< J Ine number>3 

To execute a program. 

If <I Ine number> Is specified, execution begins on that line. 
Otherwise, execution begins at the lowest line number. 
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TRON/TROFF 

To trace the execution of program statements. 

As an aid In debugging, the TRON statement (executed in either 
the direct or indirect mode) enables a trace flag that prints 
each line number of the program as is executed. The numbers 
appear enclosed In square brackets. The trace flag is disabled 
with the TROFF statement (or when a NEW command is executed). 


CLEAR C<string sp ace >C , < h i g hest location>3!3 
To set all numeric variables to zero, 
null, and close all open files, and 
of memory. 


a I I str f ng 
optional Iy, 


variables 
to set the 


to 

end 


<strIng space> 

Space for string variables. Default size Is 200 bytes. 
<Hignest !ocation> 

The highest memory location available for use by BASIC. 


DATA 


<Iist of constants> 

To store the numeric and strIng constants 
the program's READ statement(s). 


that are accessed by 


DATA statements are nonexecutable and may be placed anywhere 
in the program. A DATA statement may contain as many constants 
as will fit on a line (separated by commas), and any number of 
DATA statements may be used in a program. The READ statements 
access the OATA statements in order (by line number) and the 
data contained there in may be thought of as one continuous list 
of items, regardless of how many Items are on a line or where 
the lines are placed in the program. 


<Iist of constants) 
i . e.,f i xed point. 


may contain numeric constants in any format; 
floating point, or integer. (No numeric 
expressions are allowed in the list.) String constants in DATA 
statements must be surrounded by double quotation marks only 
if they contain comma, colons, or significant leading or trailing 
spaces. Otherwise, quotation marks are not needed. 

The variable type (numeric or string) given in the READ statement 
must agree with the correspond i ng constant in the DATA statement. 
DATA statements may be read from the beginning or specified line 
by use of the RESTORE statement. 

DIM <I Ist of subscripted variables> 

To specify the maximum values for array variable subscripts and 
allocate storage accordingly. 

If an array variable name Is used without a DIM statement, the 
maximum value of Its subscript(s) is assumed to be 10. If a 
subscript is used that is greater than the maximum specified, 
a 'Subscript out of range* error occurs. The minimum value for 
a subscript is always 0. 
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DEFINT <range(s) of le++ers> 

DEFSNG <range(s) of le++ers> 

DEFDBL <range(s) of letters> 

DEFSTR <range(s) of letters> 

To declare variable type as Integer, single precision, double 
precision, or string. 

DEFINT/SNG/DBL/STR statements declare that the variable names 
beginning with the letter(s) specified will be that type variable. 
However, a type declaration character always takes precedence 
over a DEFxxx statement in the typing of a variables. (See the 
end of section 1.5.1, for details of declaration characters.) 

DEF FN<name>C( < parameter I ist> )3 = < functlon definition> 

To define and name a function that is written by the user. 

<name> must be a legal variable name. This name, preceded by 

FN. becomes the name of the function. <parameter I Ist> is 

comprised of those variable name in the function definition thaT 
are to be replaced when the function is called. The items in 
the list are separated by commas. <function definition> is an 

expression that performs the operation of the function. It is 
-I'imfted to one line. Variable names that appear in this 

expression serve only to define the function; they do not affect 

program variables that have the same name. A variable name used 
in a function definition may or may not appear in the parameter 
list. If it does, the value of the parameter is supplied when 

the function is called. Otherwise, the current value of the 

variable Is used. 

The variables in the parameter list represent, on a one-to-one 
basis, the argument variables or values that will be given in 
the function call. 

If a type is specified in the function name, the value of the 

expression is forced to that type before It is returned to the 
calling statement. If a type is specified in the function name 
and the argument type does not match, a ’Type mismatch’ error 
occurs. 

A DEFFN statement must be executed before the function it defines 
may be called. If a function is called before it has been 
defined, an ’Undefined user function’ error occurs. DEFFN is 
illegal In the direct mode. 

DEFUSRC < dlgit>3=<Integer expression> 

To specify the starting address of an assembly language 
su brou11ne. 

< d I g11 > may be any digit from 0 to 9. The digit corresponds 
to the number of the USR routine whose address is being specified. 
If <d!git> Is omitted, DEFUSRO Is assumed. The value of <integer 
expresslon> is the starting address of the USR routine 
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Any number of DEFUSR statements may appear In a program to 
redefine subroutine starting addresses, thus allowing access 
to as many subroutines as necessary. 

ERASE <list of array varlables> 

To eliminate arrays from a program 

Arrays may be redimensioned after they are ERASEd, or the 
previously al located array space In memory may be used for other 
purposes. If an attempt is made to redimension an array without 
first ERASEing It, a *"Red imensioned array* error occurs. 


END 

To terminate program execution, close all files and return to 
command level. 

END statements may be placed anywhere in the program to terminate 
execution. Unlike the STOP statement, END does not cause a BREAK 
message to be printed. An END statement at the end of a program 
is optional. 

ERROR <integer expression> 

To simulate the occurrence of an error or to allow error codes 
to be defined by the user. 

The value of <!nteger express Ion> must be greater than 0 and 
less than 255. If the value of <Integer expression> equals an 
error code already in use by BASIC, the ERROR statement will 
simulate the occurrence of that error, and the corresponding 
error message will be printed. 

To define your own error code, use a value that is greater than 
any used by BASIC for error codes. See Appendix A for a list 
of error codes and messages. (it is preferable to use the highest 
available values, so compatibility may be maintained when more 
error codes are added to BASIC.) This user defined error code 
may then be conveniently handled In an error trap routine. 

Example: 

10 ON ERROR GOTO 1000 


120 IF A$="Y" THEN ERROR 250 


1000 IF ERR = 250 THEN PRINT '’Sure?” 


If an ERROR statement specified a code for which no error message 
has been defined, BASIC responds with the message ’Unprintable 
error*. Execution of an ERROR statement for which there Is no 
error trap routine causes an 'Unprintable error* error message 
to be printed and execution to halt. 
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FOR <var I abIe> = x TO y CSTEP z] 


NEXT C < variable>JC/ < varIable>...I] 

note: <Variable> can be I nteger,singIe-precision or double- 

precision. where x,y,z are numeric expressions. 


To allow a series of instructions to be performed in a loop a 
given number of times. 


<variable> is used as a counter. 

(x) is the initial value of 
expression (y) is the final value of 
lines following the FOR statement 
statement is encountered. Then the 
the amount specified by STEP. A 

the value of the counter is now greater than the 

(y) . If it is not greater, BASIC branches back to 


The first numeric expression 
the counter. The second numeric 
the counter. The program 
are executed until the NEXT 
counter is incremented by 
check is performed to see if 

final value 
the statement 


after the FOR statement and the process is repeated. If It is 
greater, execution continues with the statement following the 
NEXT statement. This is a FOR...NEXT loop. If STEP is not 
specified, the increment Is assumed to be one. 


If step is negative, the final value of the counter is set to 
be less than the initial value. The counter is decremented each 
time through the loop, and the loop is executed until the counter 
is less than the final' value. 


The body of the loop is executed one time at least If the initial 

value of the loop times the sign of the step exceeds the final 

value times the sign of the step. 

FOR...NEXT loops may be nested, that is, a FOR...NEXT loop may 
be placed within the context of another FOR...NEXT loop. When 
loops are nested, each loop must have a unique variable name 
as its counter. The NEXT statement for the inside loop must 
appear before that for the outside loop. If nested loops have 
the same end point, a single NEXT statement may be used for alI 

of them. Such nesting of FOR...NEXT loops is limited only by 

avai Iab I e memory. 

The variable(s) in the NEXT statement may be omitted, in which 
case the NEXT statement will match the most recent FOR statement. 
If a NEXT statement is encountered before Its corresponding FOR 
statement, a 'NEXT without FOR' error message Is issued and 
execution is terminated. 

GOSUB <I Ine number> 

RETURN C<I Ine number>3 

To branch to subroutine beginning at <l!ne number> and return 
from a subroutine. 

<I I ne number> is the first line of the subroutine. A subroutine 
may be cal led any number of times in a program, and a subroutine 
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may be called from within another subroutine. Such nesting of 
subroutines is limited only by available memory. 

The RETURN statement(s) In a subroutine cause BASIC to branch 
back to the statement following the most recent GOSUB statement. 
A subroutine may contain more than one RETURN statement, should 

logic dictate a return at different points in the subroutine. 

Subroutines may appear anywhere in the program, but it is 

recommended that the subroutine be readily distinguishable from 
the main program. To prevent inadvertent entry Into the 

subroutine, it may be preceded by a STOP, END, or GOTO statement 
that directs program control around the subroutine. Otherwise, 
a 'RETURN without GOSUB' error message is issued and execution 
i s terminated. 

GOTO <1ine number> 

To branch unconditionally out of the normal program sequence 
to a specified <1 Ine number>. 

If <1 i ne number> is an executable statement, that statement and 
those following are executed. If it is a nonexecutable statement, 
execution proceeds at the first executable statement encountered 
after <Iine numoer>. 

IF <expressfon> THEN <statement(s ) (<I I ne number> 

CELSE <statement(s)I<Iine number>3 
IF <express!on> GOTO <Iine number> 

CELSE <statement(s) f<Iine number>3 
To make a decision regarding program flow based on the resuit 
returned by an expression. 

If the result of <expression> is not zero, the THEN or GOTO clause 
is executed. THEN may be followed by either a line number for 
branching or one or more statements to be executed. GOTO is 
always followed by a line number. If the result of <expression> 
is zero, the THEN or GOTO clause is ignored and the ELSE clause, 
if present, is executed. Execution continues with the next 
executable statement. 

Examp Ie: 

A=1:B=2 -> A=B is zero (FALSE). 

A=2:b=2 -> A=B is not zero (TRUE). 

iF...THEN... ELSE statements may be nested. Nesting is limited 
only by the length of the line. If the statement does not contain 
the same number of ELSE and THEN clauses, each ELSE Is matched 
with the closest unmatched THEN. For example, 

IF A=B THEN IF B = C THEN PRINT "A=C'' 

ELSE PRINT "A<>C” 

will not print "A<>C" when A<>B. It will print "A<>C" when A=B 
and B<>C. 

If an IF...THEN statement is followed by a line number in the 
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direct mode, an 'Undefined line* error results unless a statement 
with the specified line number had previously been entered in 
The 1 nd i rect mode. 

INPUT ["<prompt string>";3<I 1st of variables> 

To allow Input from the keyboard during program execution. 

When an INPUT statement is encountered, program execution pauses 
and a question mark is printed to indicate the program is waiting 
for data. if ”<prompt str!ng>'' is included, the string is printed 
before the question mark. The required data is then entered 
at the keyboard. 

The data that is entered Is assigned to the variable(s) given 
in <variabIe !Ist>. The number of data items supplied must be 
the same as the number of variables in the list. Data items 
are separated by commas. 

The names in the <Iist of variables> may be numeric or string 
variable names (including subscripted variables). The type of 
each data item that is input must agree with the type specified 
by the variable name. (Strings input to an INPUT statement need 
not be surrounded by quotation marks.) 

Responding to input with the wrong type of value (string instead 
of the numeric, etc.) causes the message ”?Redo from start” 
to be printed. No assignment of input value is made until an 
acceptable response is given. 

Examp Ie: 
list 

10 INPUT "A and 8";A,B 
20 PRINT A+B 
Ok 
run 

A and B ? 10 , @0 
?Redo from start 
A and B? 10,20 
30 
Ok 

Responding to INPUT with too many items causes the message ”?Extra 
ignored” to be printed and the next statement to be executed. 

Example: 

I i st 

10 INPUT "A and B”;A,B 
20 PRINT A+B 
0k 
run 

A and B? 10,20 .30 
?Extra Ignored 
30 
Ok 
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Responding to INPUT with too few Item causes two question marks 
to be printed and a wait for the next data Item. 

Examp Ie: 
list 

10 INPUT "A and B";A,B 
20 PRINT A+B 
Ok 
run 

A and B? 10 (The 10 was typed in by the user) 

?? 20 (The 20 was typed in by the user) 

30 

Ok 

Escape INPUT by typing Control-C or the "CTRL'' and "STOP" keys 
simultaneously. BASIC returns to command level and types "Ok". 
Typing C0NT resumes execution at the INPUT statement. 

LINE INPUT ["<prompt str I ng> " ; ]<str i ng variable> 

; To input an entire line (up to 254 characters) to a string 

variable, without the use of delimiters. 

The prompt string Is a string literal that is printed at the 

console before input is accepted. A question mark is not printed 
unless it is part of the prompt string. All input from the end 
of the prompt to the carriage return Is assigned to <string 
var i abIe>. 

Escape LINE INPUT by typing Control-C or the "CTRL" and "STOP" 
keys simultaneously. BASIC returns to command level and types 
"Ok". Typing CONT resumes execution at the LINE INPUT statement. 

[LET] <variabIe>=<expression> 

; To assign value of an expression to a variable. 

Notice the word LET is optional; t.e., the equal sign is 
sufficient when assigning an expression to a variable name. 

LPR1NT [<I Ist of expressions>] 

LPRINT USING <str!ng expression>;<I i st of expressions> 

; To print data at the line printer. (see PRINT and PRINT USING 
statements below for details.) 

MID$(<string exp. 1>),n[,m])=<strIng exp.2 ) 

; To replace a portion of one string with another string. 

The character in <string exp.1>, beginning at position n, are 
replaced by the characters in <string exp.2>. The optional m 
refers to the number of characters from <strlng exp.2> that will 
be used in the replacement. If m is omitted or included, the 

replacement of characters never goes beyond the original length 
of <str I ng exp.1>. 

ON ERROR GOTO <1 Ine number> 

; To enable error trapping and specify the first line of the error 
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hand I i ng 


subroutine. 


Once error trapping has been enabled all errors detected, 
including direct mode errors (e.g., SN (Syntax) errors), will 
cause a jump to the specified error handling subroutine. If 
< I i ne number> does not exist, an ’Undefined line number 1 error 
results. To disable error trapping, execute an ON ERROR GOTO 
0. Subsequent errors will print an error message and halt 
execution. An ON ERROR GOTO 0 statement that appears In an error 
trapping subroutine causes BASIC to stop and print the error 
message for the error that caused the trap. It is recommended 
that all error trapping subroutines execute an ON ERROR GOTO 
0 if an error Is encountered for which there is no recovery 
action. 


If an error occurs during execution of an error handling 
subroutine, the BASIC error message is printed and execution 
terminates. Error trapping does not occur within the error 
handling subroutine. 


• ON <expression> GOTO <I Ist of line number> 

ON <express lon> GOSUB < I i st of line number> 

; To branch to one of several specified line numbers, depending 
on the value returned when an expression is evaluated. The value 
of <expression> determines which line number in the list will 
be used for branching. For example. If the value is three, the 

third line number in the list will be the destination of the 
branch. (If the value Is a noninteger, the fractional portion 
is dIscarded. ) 


In the ON...GOSUB statement, each line number in the list must 
be the first line number of a subroutine. 



If the value of <expression> is zero or greater than the number 
of items in the list (but less than or equal to 255), BASIC 
continues with the next executable statement. If the value of 
<expresston> is negative or greater than 255, a 'Illegal function 
call' error occurs. 

OUT <port number>,<Integer expression> 

; To send a byte to a machine output port. 

<port number> and <lnteger expresslon> are in the range 0 to 
255. <!nteger expresslon> is the data (byte) to be transmitted. 

POKE <address of the memory>,<integer expression> 

; To write a byte into a memory location. 

<address of the memory> is the address of the memory location 
to be POKEd. The <[nteger expression> Is the data (byte) to 
be POKEd. It must be In the range 0 to 255. And <address of 
the memory> must be in the range -32768 to 65535. If this value 
Is negative, address of the memory location is computed as 
subtracting from 65536. For example, -1 is same as the 65535 
(=65536-1). Otherwise, an 'Overflow' error occurs. 
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PRINT C < list of expressions^ 

; To output data to the console. 

If <Iist of expresslons> Is omitted, a blank line is printed. 
If <I Ist of expressions> is included, the values of the 
expressions are printed at the console. An expression in the 
list may be a numeric and/or a string expression. (Strings must 
be enclosed in quotation marks.) 

The position of each printed item is determined by the punctuation 
used to separate the items In the list. BASIC divides the line 
into print zones of 14 spaces each. In the < I Ist of expressions>, 
a comma causes the next value to be printed at the beginning 
of the next zone. A semicolon causes the next value to be printed 
Immediately after the last value. Typing one or more spaces 
between expressions has the same effect as typing a semicolon. 

If a comma or a semicolon terminates the <Iist of expressions>, 
the next PRINT statement begins printing on the same line, spacing 
accordingly. If the <Iist of expressions> terminates without 
a comma or a semicolon, a carriage return is printed at the end 
of the line. If the printed line is longer than the console 
width, BASIC goes to the next physical line and continues 
printing. ‘ 

Printed numbers are always followed by a space. Positive numbers 
are preceded by a space. Negative numbers are preceded by a 
minus sign. 

A question mark may be used In-place of the word PRINT in a PRINT 
statement. 

PRINT USING <strlng expression>;<I Ist of expressions> 

; To print strings or numerics using a specified format. 

<I Ist of expressions> comprises the string expressions or numeric 
expressions that are to be printed, separated by semicolons. 
<str!ng express Ion> is a string literal (or variable) comprising 
special formatting characters. These formatting characters (see 
below) determine the field and the format of the printed strings 
or numbers. 

When PRINT USING is used to print strings, one of three formatting 
characters may be used to format the string field: 

it t»« 


Specifies that only the first character In the given string is 
to be printed. 

Examp Ie: 

AS="Japan” 

Ok 

PRINT USING ”I”;A $ 
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Ok 

"&n spacesi” 

Specifies that 2 + n characters from the string are to be printed. 
If the backslashs are typed with no spaces, two characters will 
be printed; with one space three characters will be printed, 
and so on. If the string Is longer than the field, the extra 
characters are ignored. If the field Is longer than the string, 
the string will be Ieft-just Ified In the field and padded with 
spaces on the right. 

Examp Ie: 

A $ = "Japan" 

Ok 

PRINT USING "4 4";A$ 

J apa 
Ok 

»§" 


Specifies that the whole character in the given string is to 
be printed. 

Example: 

A S = " J a p a n " 

Ok- 

PRINT USING "I love @ very much.";A$ 

I love Japan very much. 

Ok 



When PRINT USING is used to print numbers, the following special 
characters may be used to format the numeric field: 

A number sign Is used to represent each digit position. Digit 
positions are always filled. If the number to be printed has 
fewer digits than positions specified, the number will be 
right-justified (preceded by spaces) In the field. 

A decimal point may be Inserted at any position in the field. 
If the format string specifies that a digit is to precede the 
decimal point, the digit will always be printed (as 0 if 
necessary). Numbers are rounded as necessary. 

Examp Ie: 

PRINT USING 10.2,2,3.456,.24 

10.20 2.00 3.46 0.24 

Ok 


II + II 
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A plus sign at the beginning or end of the format string will 
cause the sign of the number (plus or minus) to be printed before 
or after the number. 

Exam pie: 

PRINT USING "+/##.##";1 .25,-1 .25 
+1.25 -1.25 

Ok 

PRINT USING "###.##+";1.25,-1.25 
1.25+ 1.25- 

Ok 

If _ If 


A minus sign at the end of the format field will cause negative 
numbers to be printed with a trailing minus sign. 

Example: 

PRINT USING 1.25,-1.25 

1.25. 1 .25- 

Ok 


»«* * it 

A double asterisk at the beginning of the format string causes 
leading spaces In the numeric field to be filled with asterisks. 
The ** also specifies positions for two or more digits. 

Example: 

PRINT USING "**#.##”;1.25,-1.25 
**1.25 *-1.25 
Ok 


'r " 


A double yen sign causes a yen sign to be printed to the immediate 
left of the formatted number. The ¥¥ specifies two more digit 
positions, one of which is the yen sign. The exponential format 
cannot be used with ¥¥. Negative numbers cannot be used unless 
the minus sign trails to the right. 

Exam pie: 

PRINT USING "¥¥###.##»;12.35,-12.35 
Y12.35 -¥12.35 
Ok 

PRINT USING "¥¥#*#.##-";12.35,-12.35 
¥12.35 ¥12.35- 

Ok 

n # * % v 


The **■¥ at the beginning of a format string combines the effects 
of the above two symbols. Leading spaces will be aster i sk-f i I Ied 
and a yen sign will be printed before the number. **¥• specifies 
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three more digit positions, one of which is the yen sign. 

Examp Ie: 

PRINT USING "**¥#.##";12.35 

*¥12.35 

Ok 

I? ff 
9 

A comma that is to the left of the decimal point in a formatting 
string causes a comma to be printed to the left of every third 
digit to the left of the decimal point. A comma that is at the 
end of the format string is printed as part of the string. A 
comma specifies another digit position. The comma has no effect 
if used with the exponential format. 

Example: 

PRINT USING "####,.##";1234.5 

1,234.50 

Ok 

PRINT USING 1234.5 

1234.50. 

Ok 

"AAAAH 

Four carats may be placed after the digit position characters 
to specify exponential format. The four carats allow space for 
E+xx to be printed. Any decimal point position may be specified. 
The significant digits are Ieft-justified, and the exponent is 
adjusted. Unless a leading + or trailing + or is specified, 

one digit position will be used to the left of the decimal point 
to print a space or minus sign. 

Exam pIe: 

PRINT USING "##. ##''aaa" ; 234.56 
2.35 E+02 
Ok 

PRINT USING w #./# aaaa“";- 12.34 
1 .23 E+01 - 
Ok 

PRINT USING "+#.##aaaa" ; 12.34,-12.34 
+ 1 .23 E+0 1 -1 .23 E+0 1 
Ok 

"%»» 

If the number to be printed is larger than the specified numeric 
field, a percent sign is printed in front of the number. Also, 
If rounding causes the number to exceed the field, a percent 
sign will be printed In front of the rounded number. 


Example: 

PRINT USING "##.##";123.45 
$123.45 
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Ok 

PRINT USING 999 

%] .00 

Ok 

If the number of digits specified exceed 24, an 'Illegal function 
call’ error will result. 

READ <I Ist of varlab|es> 

; To read values from a DATA statement and assign them to variables. 

A READ statement must always be used In conjunction with a DATA 
statement. READ statements assign variables to DATA statement 
values on a one-to-one basis. READ statement variables may be 

numeric or string, and the values read must agree with the 
variable types specified. If they do not agree, a 'Syntax error' 
will resuIt. 

A single READ statement may access one or more DATA statements 
(they will be accessed In order), or several READ statements 
may access the same DATA statement. If the number of variables 
in <I Ist of variables> exceeds the number of elements in the 

DATA statement(s), an 'Out of DATA' error will result. If the 
number of variables specified is fewer than the number of elements 
in the DATA statement(s), subsequent READ statements will begin 
reading data at the first unread element. If there_ are no 

subsequent READ statements, the extra data is ignored. 

To reread DATA statements from the start, use the RESTORE 
statement. 

REM <remark> 

; To allow explanatory remarks to be inserted in a program. 

REM statements are not executed but are output exactly as entered 
when the program is listed. 

REM statements may be branched into (from a GOTO or G0SU8 
statement), and execution will continue with the first executable 
statement after the REM statement. 

Remarks may be added to the end of a line by preceding the remark 
with a single quotation mark instead of :REM. • 

Do not use this in a DATA statement as it would be considered 
legal data. 

RESTORE C< IIne number>U 

: ; To allow DATA statements to be reread from a specified line. 

After a RESTORE statement is executed, the next READ statement 
accesses the first item In the first DATA statement in the 
program. If <!lne number> Is specified, the next READ statement 
accesses the first I tern In the specified DATA statement. If 
a nonexistent line number Is specified, an 'Undefined Line number' 
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error will resuIt. 


RESUME 

RESUME 0 

RESUME NEXT 

RESUME <1 Ine number> 

; To continue program execution after an error recovery procedure 
has beerr performed. 

Any one of the four formats shown above may be used, depending 
upon where execution is to resume: 

RESUME or RESUME 0 

Execution resumes at the statement which caused the error. 

RESUME NEXT ^ 

Execution resumes at the statement Immediately following the 

one which caused the error. 

RESUME <line number> 

• Execution resumes at <1ine number> 

A RESUME statement that is not in an error trap subroutine causes 
a 'RESUME without' error. 

STOP 

; To terminate program execution and return to command level. 

STOP statement may be used anywhere in a program to terminate 
execution. When a STOP statement is encountered, the following 
message is printed: 

Break in nnnn (nnnn is a line number) 

Unlike the END statement, the STOP statement does not close files. 

Execution is resumed by Issuing a CONT command. 

SWAP <variabIe>,<varIabIe> 

; To exchange the value of two variables. 

Any type of variable may be SWAPed (integer, single precision, 
double precision, string),but the two variable must be of the 
same type or a 'Type mismatch' error results. 

WAIT <port number>, I C,JD < 

; To suspend program execution while monitoring The status of a 

machine input port. 

The WAIT statement causes execution to' be suspended until a 
specified machine Input port develops a specified bit pattern. 
The data read at the port Is exclusive OR'ed with the integer 
expression J, and then AND'ed with integer expression I. 
the result Is zero, BASIC loops back and reads the data at the 
port again. If the result Is non-zero, execution continues with 
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the next statement. 


If J Is omitted. It Is assumed to be zero. 
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2.1.3 Functions, except I/O 
ABS(X) 

; Returns the absolute value of the expression X. 

ASC(XS) 

; Returns a numerical value that is the ASCII code of the first 
character of the string X$. If X $ is null, a ’Illegal function 
call' error is returned. 


ATN(X) 

; Returns the arctangent of X in radians. Result is in the ranee 
-pi/2 to pf/2. The expression X may be any numeric type, but 
the evaluation of ATN is always performed in double precision. 

B I N $ ( n ) 

; Returns a string which represents the binary value of the decimal 
argument. 

n is a numeric expression in the range -32768 to 65535. If n 
is negative, the two's complement from is used. That Is, BINS(-n) 
is the same as B I N$(65536-n). 

CDBL(X) 

; Converts X to a double precision number. 

CHR$(I) 

; Returns a string whose one element is the ASCII code for 1. ASCS 
is commonly used to send a special character to the console, 
etc. 

C1NT(X) 

; Converts X to a integer number by truncating the fractional 
portion. if X isn't the range -32768 to 32767, an 'Overflow' 
error occurs. 

COS(X) 

; Returns the cosine of X in radians. COS(X) Is calculated to 
doubIe precis I on. 

CSNG(X) 

; Converts X to a single precision number. 

CSRL IN 

; Returns the vertical coordinate of the cursor. 

EOF C < fI Ie number>) 

; Return -1 (true) if the end of a sequential file has been reached. 
Use EOF to test for end-of-file while INPUTing, to avoid 'Input 
past end' errors. 

ERL/ERR 

; When an error handl Ing subroutine Is entered, the variable ERR 
contains the error code for error. and the variable ERL contains 











Language spec i fication for MSX BASIC 


Page 38 


the I I ne number of the line In which the error was detected. 
The ERR and ERL variables are usually used In IF...THEN statements 
to direct program flow In the error trap routine. 

If the statement that caused the error was a direct mode 
statement, ERL will contain 65535. To test if an error occurred 
in a direct statement, use 

IF 65535=ERL THEN . 

OtherwIse, use 

IF ERL=<line number> THEN .... 

IF ERR=<error code> THEN.... 

Because ERL and ERR are reserved variables, neither may appear 
to the left of the equal sign In a LET (assignment) statement. 

EXP(X) 

; Returns e to the power of X. X must be <=145.06286085862. If 
EXP overflows, the ’Overflow* error message Is printed. 

FIX(X) 

; Returns the integer part of X (fraction truncated). FIX(X) is 
equivalent to SGN(X)* INT(ABS(X)). The major difference between 
FIX and I NT is that FIX does not return the next lower number 
for negative X. 

FRE(0) 

FRE("" ) 

; Arguments to FRE are dummy arguments. FRE returns the number 
of bytes In memory not being used by BASIC. 

FRE(O) returns the number of bytes In memory which can be used 
for BASIC program. text file, machine language program file, 
etc. FRE(””) returns the number of bytes in memory for string 
space. 

HEXS(X) 

; Returns a string which represents the hexadecimal value of the 
decimal argument. 

n is a numeric expression in the range -32768 to 65535. If n 
Is negative, the two's complement from is used. That Is, HEXS(-n) 
is the same as HEXS(65536-n). 


INKEYS 

; Returns either a one-character string containing a character 
read from the keyboard or a nuIJ string If no key Is pressed. 
No characters will be echoed and all characters are passed through 
to the program except for Control-C, which terminates the program. 


I NP( I) 

; Returns the byte read from the port I. I must be in the range 
0 to 255. INP Is the complementary function to the OUT statement. 
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1NPUTS(X) 

; Returns a string of X characters, read from the keyboard. No 
character will be echoed and alI characters are passed through 
except Control-C, terminates the execution of the INPUTS function. 

INSTR(CI,]X$,YS) 

; Searches for the first occurrence of string YS in XS and returns 
the position at which the match is found. Optional offset I 
sets the position for starting the search. I must be in the 
range 0 to 255 . If I >L EN(X S) or if XS is null or If YS cannot 
be found or if XS and YS are null, INSTR returns 0. If only 
YS is null, INSTR returns I or 1. XS and YS may be string 
variables, string expressions, or string literals. 

I NT(X) 

; Returns the largest integer <=X. 

LEFTS(XS,I) 

; Returns a string comprising the leftmost I characters of XS. 

I must be In the range 0 to 255. If I is greater than LEN(XS), 
the entire string (XS) is returned. If 1=0, a null string (length 
zero) is returned. 

LEN(XS) 

; Returns the number of characters in XS. Nonprinting characters 
and blanks are counted. 

LOG(X) 

; Returns the natural logarithm of X. X must- be greater than zero. 

LPOS(X) 

; Returns the current position of the line printer print head within 
the line printer buffer. Does not necessarily give the physical 
position of the print head. X is a dummy argument. 

MIDS(XS, 1C,J]) 

; Returns a string of length J characters from XS beginning with 
the I th character. I and J must be In the range 1 to 255 . If 
J is omitted or if there are fewer than J characters to the right 
of the Ith character, all rightmost characters beginning with 
the Ith character are returned. If l>LEN(X$), MIDS returns a 
null string. 

OCT $(n ) 

; Returns a string which represents the octal value of the decimal 
argument. 

n is a numeric expression in the range -32768 to 65535. If n 
Is negative, the two's complement from is used. That Is, OCTS(-n) 
Is the same as OCTS(65536-n). 

PEEK(I) 

; Returns the byte (decimal Integer in the range 0 to 255.) read 
from memory location I. I must be In the range -32768 to 65535. 
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PEEK is the complementary function to the POKE statement. 

POS(I) 

; Returns the current cursor position. The leftmost position is 
0. lisa dummy argument. 

RIGHTS(X $, I) 

; Returns the rightmost I characters of string X$. If l=LEN(X$), 

return'XI. If 1=0, a null string (length zero) Is returned. 

RND(X) 

; Returns a random number between 0 and 1. The same sequence of 

random number is generated each time the program is RUN. If 

X<0, the random generator is reseeded for any given X. X=0 

repeats the last number generated. X>0 generates the next random 
number in the sequence. 


SGN(X) 

; Returns 1 (for X>0), 0 (for X=0) , -1 (for X<0). 

• SIN(X) 

; Returns the sine of X in radians. SiN(X) is calculated to double 
precisI on. 

SPACES(X) 

; Returns the string of spaces of length X. The expression X 
discards the fractional portion and must be range 0 to 255. 


SPC(I) 

; Prints I blanks on the screen. SPC may only be used with PRINT 
and LPRINT statements. I must be in the range 0 to 255. 


SQR(X) 

; Returns the square root of X. X must be >=0. 

STR $(X) 

; Returns a string representation of the value of X. 

STRING$(I,J) 

STR!NG$(I , X$) 

; Returns a string of length I whose characters al I have ASCI I 
code J or the first character of the string X$. 

TAB( I ) 

; Spaces to position I on the console. If the current print 
position is already beyond space I, TAB does nothing. Space 

0 is the leftmost position, and the rightmost position Is the 
width minus one. I must be in the range 0 to 255. TAB 'may only 
be used with PRINT and LPRINT statements. 

TAN(X) 

; Returns the tangent of X In radians. TAN(X) Is calculated to 
double precision. If TAN overflows, an 'Overflow' error will 

occu r. 
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USR[<dIgi+>1(X) 

; Calls the user's assembly language subroutine with the argument 
X. < d I g11 > is In the range 0 to 9 and corresponds to the digit 
supplied with the DEFUSR statement for that routine. If <dIgit> 
is omitted, USRO is assumed. 

VAL(XS) 

; Returns the numerical value of the string X$. The VAL function 
also strips leading blanks, tabs, and I inefeeds from the argument 
string. For example 

PRINT YALC" -7") 

-7 

Ok 

VARPTR(<variabIe name>) 

VARPTR(#<fI Ie number>) 

; Returns the address of the first byte of data identified with 
<variable name>. A value must be assigned to <varfable name> 
prior to execution of YARPTR. Otherwise, an 'Illegal function 
cal I.' error results. Any type variable name may be used (numeric, 
string, array), and the address returned wiil be an integer in 
the range -32768 to 32767. If a negative address is returned, 
add it to 65536 to obtain the actual address. 

VARPTR Is usually used to obtain the address of a variable or 
array so it may be passed to an machine language subroutine. 

A function call of the form VARPTR(A(0)) is usually specified 
when passing an array, so that the I owest-add ress element of 
the array Is returned. 

All simple variables should be assigned before calling VARPTR 
for an array because the address of the arrays change whenever 
a new simple variable is assigned. If #<fi!e number> is 
specified, VARPTR returns the starting address of the file control 
bIock . 
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2.2 Device specific statements and functions. 

- Expanded statements and functions for MSX -— 

2.2.1 Statements 

SCREEN C < fnode > , < s p r I te si z e>3C,<key click switch>3 
C,<cassette baud rate>]]C» < pr I nter option>3 

; To assign the screen mode, sprite size, key cl Ick, cassette baud 
rate and printer option. 

<mode> should be set to 0 to select 40x24 text mode, 1 to select 
32x24 text mode, 2 to select high resolution mode, 3 to select 
multi color (low-resolution mode). 

0:40x24 text mode 
1 :32x24 text mode 
2:.high resolution mode 
3:multi color mode 

<sprite size> determines the size of sprite. Should be set to 
0 to select 8x8 unmagnified sprites, 1 to select 8x8 magnified 
sprites, 2 to select 16x16 unmagnified sprites, 3 to select 16x16 
magnified sprites. NOTE: If <sprite size> is specified, the 

contents of SPRITES will be cleared. 

0:8x8 unmagnified 
1 : 8x8 magn i.f I ed 
2:16x16 unmagnified 
3:16x16 magnified 

<key click switch> determines whether to enable or disable the 
key click. Should be set to 0 to disable it. 

0:disable the key click 
1:enable the key click 

Note that in text mode, alI graphics statements except 'PUT 
SPRITE' generate an 'll legal function cal I ' error. Note also 

that the mode is forced to text mode when an 'INPUT' statement 
is encountered or BASIC returns to command level. 

<cassette baud rate> determines the default baud rate for 

succeeding write operations. 1 for 1200 baud, and 2 for 2400 

baud. Baud rate can also be determined using CSAVE command with 
baud rate option. 

Note that when reading cassette, baud rate is automatically 
determined, so the user don't have to know In what baud rate 
the cassette Is written. <printer option> determines If the 
printer In operation is 'MSX printer' (which has 'graphics symbol' 
and 'HIRAGANA' capability) or not. Should be non-0 If the printer 
does not have such capability. In this case, graphics symbols 
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are converted to spaces, and HIRAGANA characters are converted 
to equivalent KATAKANA characters. 


WIDTH <width of screen in text mode> 

; To Set the width of display during 
1..40 in 40x24 text mode, 1..32 in 


text mode. Legal 
32x24 text mode. 


value Is 


CL S 


To clear the screen. 


Valid in all 


screen modes. 


LOCATE [<x>][,<y>][,<cursor 
; To locate character 
can be specified only 


display switch>l 
position for PRINT, 
in text mode. 


<cursor display switch> 


0:dIsabIe the cursor display 
1 : enabIe the cursor display 


COLOR 

f 


[^foreground color>3C» < background 
To define the color. Defaults to 
in the range of 0..15. Actual 
is as follows. 


coI or>3C,<border color>U 
15,4,7. The argument can be 
color corresponding to each value 


0 transparent 

1 bIack 

2 medI urn green 

3 light green 

4 dark blue 

5 light blue 

6 dark red 

7 cyan 

8 medium red 

9 light red 

10 dark yellow 

11 light yellow 

12 dark green 

13 magenta 

14 gray 

15 white 


PUT SPRITE <sprite plane number>C»<coordInate spec ifier>3C,<co1 or>1 
C,<pattern number>3 
; To set up sprite attributes. 

<sprite plane number> may range from 0 to 31. 

coordinates specified always can come in one of two forms 


STEP ( x offset, y offset) or 
( absolute x, absolute y) 


The first form is a point relative to the most recent + 
referenced. The second form is more common and dire X„, m0 |' ec 
to a point without regard to the last point reference . P 

are: 


t 
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( 10 . 10 ) 

STEP (10,0) 
( 0 . 0 ) 


absoIute form 

offset 10 in x and 0 in y 

origin 


Note that when Basic scans coordinate values it will allow them 
to be beyond the edge of the screen, however values outside the 
integer range (-32768 to 32767) will cause an overflow error. 

Note that (0.0) is always the upper left hand corner. It may 
seem strange to start numbering y at the top so the bottom left 
corner is (0.191) In both high-re so IutI on and medium resolution, 
but this is the standard. 

Above description can be appI led wherever graphic coordinate 
is used. 

X coordinate <x> may range from -32 to 255. Y coordinates <y> 
may range from -32 to 191. If 208 (&HD0) is given to <y>, all 
sprite planes behind disappears until a value other than 208 
is given to that plane. If 209 (&HD1) Is specified to < y > » then 
that sprite disappears from the screen. (Refer to YDP manual 
for further details.) 

When a field is omitted, the current value Is used. At start 
up, color defaults to the current foreground color. 

<pattern number> specifies the pattern of sprite, and must be 
less than 256 when size of sprites if 0 or 1, and must be less 
than 64 when size of sprites is 2 or 3. <pattern number> defaults 
to the <sprite plane number>. (See also SCREEN statement and 
SPRITES var table) 

CIRCLE <coordInate specifIer>,<radius>C t < coI or>3 

C,<start angIe>3C , <end angIe>3C,<aspect ratio>3 
; To draw an ellipse with a center and radius as indicated by the 
first of its arguments. 

<coordInate specif!er> specifies the coordinate of the center 
of the circle on the screen. For the detaiI of <coordinate 
specifier?-, see the description at PUT SPRITE statement. 

The <coI or > defaults to foreground color. 

The <start ang!e> and <end angle> parameters are radian arguments 
between 0 and 2*PI which allow you to specify where drawing of 
the ellipse will begin and end. If the start or end angle Is 
negative, the ellipse will be connected to the center point with 
a line, and the angles will be treated as if they were positive 
(Note that this Is different than adding 2*PI) . 

The <aspect ratio> is for horizontal and vertical ratio of the 
el I Ipse. 

DRAW <str!ng express!on> 

; To draw figure according to the graphic macro language. 








i 

i 


, *- 

k 
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The graphic macro language commands are contained In the string 
expression string. The string defines an object, which is drawn 
when.BASIC executes the DRAW statement. During execution, BASIC 
examines the value of string and interprets single letter commands 
from the contents of the string. These commands are detailed 
below: 

The following movement commands begin movement from the last 
point referenced. After each command, last point referenced 
is the last point the command draws. 


u 

n 

;Moves 

up 





D 

n 

;Moves 

down 





L 

n 

;Moves 

left 





R 

n 

;Moves 

r I ght 





E 

n 

;Moves 

diagona1 1 y 

up 

un d 

right 

F 

n 

;Moves 

d t agona1 1 y 

down 

and right 

G 

n 

;Moves 

dIagona1 1 y 

down 

and left 

H 

n 

;Moves 

dIagona1 1 y 

up 

and 

1 eft 


n in each of the preceding commands indicating the distance to 
move. The number of points moved is n times the sealing factor 
(set by the S command). 

M x,y ;Moves absolute or relative. If x has a plus 

sign(t) or a minus sign(-) in front of it, it 

is relative. Otherwise, it is absolute. 

The aspect ratio of the screen is 1. So 8, horizontal points 

are equal in length to 8 vertical points. 

The following two prefix commands may precede any of the above 
movement commands. 

B ;Moves, but doesn’t plot any points. 

N ;Moves, but returns to the original position 

when finished. 

The following commands are also available: 

A n ;Sets angle n. n may range from 0 to 3, where 

0 is 0 degree, I. is 90, 2 Is 180, 3 is 270. 

0 

I 

1--+--3 

1 

2 

C n ;Sets color n. n may range 0 to 15. 

S n ;Sets scale factor. n may range from 0 to 255. 

n divided by 4 Is the scale factor. For example. 
If n=1, then the scale factor is 1/4. The scale 
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factor multiplied by the distance given with 
the U,0,L,R,E,F,G,H, and relative M commands 
gives the actual distance moved. The default 
value is 0, which means 'no-scaling' (I.e., 
same as S4) 


X<string varIabIe>; 

{Executes substring. This allows you to execute 
a second string from within a string. 


Example A$ ="U80R80D80L80":DRAW "XAS;" 
->Draws a square 


In all of these commands, the n,x, or y argument can be a constant 
like 123 or it can be ' = <variabIe>; ' where <var!abie> is the 
name of a numeric variable. The semicolon (;) is required when 
you use a variable this way, or in the X command. Otherwise, 
a semicolon is optional between commands. Spaces are ignored 
in string. Foe example, you could use variables in a move command 
this way: 


XI=40:X2=50 

DRAW "M+=x1;,-=X2” 

The X command can be a very useful ' part of DRAW, because you 

can define a part of an object separate from the entire object 

and also can use X to draw a string of commands more than 255 
characters Iong. 

LINE [^coordinate spec i f I er >[]~Coor d I nate specifier>C, < coI or>3 
[, <81I8F>] 

; To draw line connecting the two specified coordinate. For the 

detail of the <coord!nate specifier>, see description at PUT 

SPRITE statement. 

If 'B'is specified, draws rectangle. If 'BF' is specified, fills 
recta n gIe. 

PAINT <coordinate spec IfIer>C,<paint coI or>3C,<coI or regarded 
as border>3 

; To fill In an arbitrary graphics figure of the specified fill 
color starting at Coordinate specifiers For the detail of 
the Coordinate specifier>, see the description at PUT SPRITE 
statement. 

Note that PAINT must not have border for high resolution graphics, 
border can be specified only in multicolor mode. in high 
resolution graphics mode, paint color is regarded as border color. 

PSETcoord I nate spec! f I er>C,Col or >3 
PRESETcoord I nate spec I f i er>C, Co I or >3 

; To set/reset the specified coordinate. For the detail of the 
Coordinate specifter>, see the description at PUT SPRITE 
statement 
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The only difference between PSET and PRESET Is that if no <color> 
is given in PRESET statement, the background color is selected. 
When a <color> argument is given, PRESET Is identical to PSET. 

KEY <function key #>,<string expression> 

; To set a string to specified function key. <functlon key #> 

must be in the range 1 to 8. <string expression> must be within 
15 characters. 

Example: 

KEY 1,"PRINT T!MES"tCHR$( 13) 

AS="Japan" 

KEY 2,AS 


KEY LIST 

; To list the contents of all function keys. 

Exam pIe: 

KEY LIST 
co I or 
auto 
goto 
I i st 
run 

color 15,7,7 
c I oa d " 
cont 
list. 

run 

Ok 

"color" aligns with key "fl", "auto" with "f2", "goto" with "f3", 
and so on. Position in the Iist reflects the key assignments. 
Note that control characters assigned to a function key is 
converted to spaces. 

ON KEY GOSUB <I?st of line numbers> 

; To set up a line numbers for BASIC to trap to when the function 
keys Is pressed. 

example 

ON KEY GOSUB 1 00,200 , , 400 , , 500 

When a trap occurs, an automatic KEY(n)ST0P is executed so receive 
traps can never take place. The RETURN from the trap routine 
will automatically do a KEY(n)0N unless an explicit KEY(n)0FF 
has been performed inside the trap routine. 

Event trapping: does not take place when BASIC is not execution 
a program. When an error trap (resulting from an ON ERROR 
statement) takes place this automat I caI Iy disables airtrapping 
(Including ERROR, STRIG, STOP, SPRITE, INTERVAL and KEY). 

KEY (< f unctI on key #>) 0N/0FF/ST0P 

; To activate/deactivate trapping 


of the specified function key 
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in a BASIC program. 

A KEY(n)ON statement must be executed to activate trapping of 
function key. After KEY C n)ON statement. If a line number is 
specified in the ON KEY GOSUB statement then every time BASIC 
starts a new statement It will check to see If the specified 
key was pressed. If so it will perform a GOSUB to the line number 
specified in the ON KEY GOSUB statement. 

If a KEY(n)OFF statement has been executed, no trapping takes 
place and the event is not remembered even if it does take place. 

If a KEY(n)STOP statement has been executed, no trapping will 
take place, but if the specified key is pressed this is remembered 
so an immediate trap will take place when KEY(n)0N is executed. 

KEY(n)ON has no effect on whether the function key value are 
displayed at the bottom of the console. 


ON STRIG GOSUB <Iist of line numbers> 

; To set up a Iine numbers for 3ASIC to trap to when the trigger 
button is pressed. 


Example: 

ON STRIG GOSUB ,200,,400 

When the trap occurs an automatic STRIG(n)STOP is executed so 
receive traps can never take place. The RETURN from the trap 
routine will automatically do a STRIG(n)0N unless an explicit 
STRIG(n)0FF has been performed inside the trap routine. 

Event trapping does not take place when BASIC is not executing 
a program. When an error trap (resulting from an ON ERROR 
statement) takes place this automatically disables all trapping 
(including ERROR, STRIG, STOP, SPRITE, INTERVAL and KEY). 


STRIG (< n > ) ON/OFF/STOP 

; To activate/deactivate trapping of trigger buttons of joy sticks 
in a BAS IC program. 

<n> can be in the range of 0..4. If <n>=0, the space bar is 
used for a trigger button. If <n> is either 1 or 3, the trics er 
of a joy-stick 1 is used. When <n> is either 2 or 4, joy — stick 

2 . 

A STR!G(n)0N statement must be executed to activate trapping 
of trigger button. After STR!G(n)0N statement, if a I Ine number 
is specified in the ON STRIG GOSUB statement then every time 
BASIC starts a new statement it will check to see If the tr i gger 
button was pressed. If so it will perform a GOSUB to the line 
number specified In the ON STRIG GOSUB statement. 

If a STRIG(n)OFF statement has been executed, no trapping takes 
place and the event is not remembered even if It does take place. 
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If a STRIG(n)STOP statement has been executed, no trapping will 
take place, but if the trigger button Is pressed this is 
remembered so an immediate trap will take place when STRIG(n)ON 
Is executed. 

ON STOP GOSUB <1 I ne number> 

; To set up a line numbers for BASIC to trap to when the 

Control-STOP key is pressed. 

When the trap occurs an automatic STOP STOP is executed so receive 
traps can never take place. The RETURN from the trap routine 
will automatically do a STOP ON unless an explicit STOP OFF has 
been performed inside the trap routine. 

Event trapping does not take place when BASIC is not execution 

a program. When an error trap (resulting from an ON ERROR 

statement) takes place this automatically disables all trapping 
(including ERROR, STRIG, STOP, SPRITE, INTERVAL and KEY). 

The user must be VERY careful when using this statement. For 
example, following program cannot be aborted. The only way left 
is to reset the system! 

example: 10 ON STOP GOSUB 40 
20 STOP ON 
30 GOTO 30 
40 RETURN 


STOP 0N/0FF/ST0P 

; To activate/deactivate trapping of a controI-STOP. 

A STOP ON statement must be executed to activate trapping of 
a controI-STOP. After STOP ON statement, if a line number is 
specified In the ON STOP GOSUB statement then every time BASIC 
starts a new statement it will check to see If a control-STOP 
was pressed. If so, it will perform a GOSUB to the line number 
specified in the ON STOP GOSUB statement. 

If a STOP OFF statement has been executed, no trapping takes 
place and the event is not remembered even if it does take place. 

If a STOP STOP statement has been executed, no trapping will 
take place, but if a control-STOP is pressed this is remembered 
so an immediate trap wilI take place when STOP ON is executed. 

ON SPRITE GOSUB <1ine number> 

; To set up a line number for BASIC to trap to when the sprites 
coincide. 

When the trap occurs an automatic SPRITE STOP is executed so 
receive traps can never take place. The RETURN from the trap 
routine will automatically do a SPRITE ON unless an explicit 
SPRITE OFF has been performed Inside the trap routine. 

Event trapping does not take place when BASIC Is not execution 
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a program. When an error trap (resulting from an ON ERROR 
statement) takes place this automatically disables all trapping 
(including ERROR, STRIG, STOP, SPRITE, INTERVAL and KEY). 

SPRITE ON/OFF/STOP 

; To activate/deactivate trapping of sprite in a BASIC program. 

A SPRITE ON statement must be executed to activate trapping of 
sprite. ' After SPRITE ON statement, if a line number is specified 
in the ON SPRITE GOSUB statement then every time BASIC starts 
a new statement it will check to see if the sprites coincide. 

If so it will perform a GOSUB to the line number specified in 

the ON SPRITE GOSUB statement. 

If a SPRITE OFF statement has been executed, no trapping takes 
place and the event is not remembered even if it does take place. 

ff a SPRITE STOP statement has been executed, no trapping will 
take place, but if the sprites co i nc i d-e this is remembered so 

an Immediate trap will take place when SPRITE ON is executed. 

ON INTERVAL=<tI me Interval> GOSUB <I I ne number> 

; To set up a line number for BASIC to trap to time interval. 

Generates a timer interrupt at every <time i n terv a I >/60‘ second. 

When the trap occurs an automatic INTERVAL STOP is executed so 
receive traps can never take place. The RETURN from the trap 
routine will automatically do a INTERVAL ON unless an explicit 
INTERVAL OFF has been performed Inside the trap routine. 

Event trapping does not take place when BASIC is not executing 
a program. When an error trap (resulting from an ON ERROR 
statement) takes place this automatically disables all traps 
(including ERROR, STRIG, STOP, SPRITE, INTERVAL and KEY). 

INTERVAL ON/OFF/STOP 

; To activate/deactivate trapping of time interval in a BASIC 
program. 

A INTERVAL ON statement must be executed to activate trapping 
of time interval. After INTERVAL ON statement, if a line number 
is specified in the ON INTERVAL GOSUB statement then every time 
BASIC starts a new statement It will check the time interval. 
If so It will perform a GOSUB to the line number specified in 
the ON INTERVAL GOSUB statement. 

If a INTERVAL OFF statement has been executed, no trapping takes 
place arvd the event Is not remembered even if it does take place. 

If a INTERVAL STOP statement has been executed, no trapping will 
take place, but if the timer Interrupt occur, this is remembered 
so an immediate trap will take place when INTERVAL ON is executed. 

VPOKE <address of VRAM>,<value to be written> 
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To poke a value to specified location of VRAM 
can be in the range of 0 .. 1 6383 . <value to be 
be a byte value. 


<address of VRAM> 
wr f tten> shouId 


BEEP 

; To generate a beep sound. 
CHR $(7) . 


exactly the same with outputting 


MOTOR [<0N1f0FF>] 


To change the status of cassette motor switch. When no argument 

is given, flips the motor switch. Otherwise, enables/disables 
motor of cassette. 


SOUND <register of PSG>,<value to be written> 


; To write value directly to the <register of PSG>. 

PLAY <str!ng exp for voice 1>C,<string exp for voice 2> 
for voice 3>HD 


L ,<str i ng 


exp 


To play music according to music macro language. 

PLAY implements a concept similar to DRAW by embedding a "music 

n> C i"s I a ^?r a n e " ' n + ° - a character string. <strfng exp for voice 
n> is a string expression consisting of single character music 

rpmI!?nf S * • . WH ! n * nU !’ strin S ]s specified, the voice channel 
emains silenT. The single character commands in PLAY are: 


A to G w i-th optional #, + ,or - 

,Plays The indicated note in the current octave. 
A number sign(#) or plus sign(t) afterwards 
indicates a sharp, a minus sign(-) indicates 
a flat. The #,+, cr - Is not allowed unless 
it corresponds to a black key on a piano. For 
example, B# is an invalid note. 


0 n 


;0ctave. Sets the current octave 
following notes. There are 8 octaves, 
to 8. Each octave goes from C to B. 
4 is the default octave. 


for the 
numbered 
Octave 


;Plays note n. . n may range from 0 to 96. n=Q 
means rest. This is an alternative way of 

selecting notes besides specifying the octave(0 
n) and the note name (A~G). (The C of octave 
4 is 36. ) 


• Sets the length of the following notes. The 
actual note length is 1/n. n may range from 
64. The following table may.help explain 

this: 


Length 

LI 


Equivalent 
whole note 
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L2 

half note 


L3 

one of a triplet of 

three 


half notes (1/3 of a 4 
measure) 

beat 

L4 

quarter note 


L5 

one of a quintuplet 

of a measure) 

(1/5 

L6 

• 

one of a quarter note triplet 

L64 

sixty-forth note 



•I- 

it- 


i' 



The length may also follow the note when you 

want to change the length only for the note. 
For example, A1 6 is equivalent to L16A. 

R n ;Pa use(rest) . n may range from 1 to 64, and 

figures the length of the pause In the same 
way as L(Iength). 

. ;(Dot or period) After a note, causes the note 

to be played as a dotted note. That is, its 
length is multiplied by 3/2. More than one 
dot may appear after the note, and the length 
is adjusted accordingly.' For example, "A..." 
will play 27/8 as long, etc. -Dots may also 

appear after the pause(P) to scale the pause 
length in the same way. 


T 

n 

;Tempo. Sets 

the number 

of quarter 

notes in 



a minute. n 

may range 

from 32 to 

25 5 . 

The 



defauit is 120. 




V 

n 

;Vo 1ume. Sets 

the volume 

of output. n 

may 

range 



f rom 0 to 15. 





M 

n 

;Mod u1 ation. 

Sets period 

of envelope 

. n 

may 



range from 1 

to 65535. 




S 

n 

;Shape. Sets 

shape of 

enve1 ope. n 

may 

range 


from 1 to 15. The pattern set by this command 
are as follows: 


0.1 ,2,3,9 


4,5,6,7,15 
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X<variabIe>; 

;Execu+es specified string. 

In all of these commands the n argument can be a constant like 

12 or it can be "=<varIabIe>;" where variable is the name of 

a variable. The semicolon(j) is required when you use a variable 
in this way, and when you use the X command. Otherwise, a 

semicolon is optional between commands. 

MAXFILES=<express fon> 

; To specify the maximum number of files opened at -.a time. 

<expresston> can be In the range of 0..15. When 'MAXFILES 5 ^' 
Is executed, only SAVE and LOAD can be performed. 

The default value assigned is 1. 

OPEN "<devIce_descrIptor>C < fI Ie name>]" [FOR <mode>3 
AS C#3 < 'flle number> 

; To allocate a buffer for i/0 and set the mode that will be used 
with the buffer. 

This statement opens a device for further processing. Currently, 
following devices are supported. 

CAS: cassette 

CRT: CRT screen 

GRP: Graphic screen 
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LPT: line printer 

Device descriptors can be added using the ROM cartridge. See 
SLOT.MEM for further details. 

<mode> is one of the following: 

OUTPUT : Specifies sequential output mode 

INPUT : Specifies sequential input mode 

APPEND : Specifies sequential append mode 

<file number> Is an integer expression whose value Is between 
one and the maximum number of files specified In a MAXFILES= 
statement. 

<f[|e number> Is the number that Is associated with the file 
for as long as It is OPEN and Is used by other I/O statements 
to refer to the file. 

An OPEN must be executed before any I/O may be done to the file 
using any of the following statements, or any statement or 
function requiring a file number: 

PRINT #, PRINT g USING 
INPUT #, LINE'INPUT g 
INPUTS, GET, PUT 

PRINT #<file number>,<exp> 

PRINT #<f iIe number>,US ING <string expression>;<I Ist of expression> 

; To write data to the specified channel. (See PRINT/PRINT USING 
statements for details.) 

INPUT #<fiie number>,<variabIe list> 

; To read data items from the specified channel and assign them 
to program variables. 

The type of data in the file must match the type specified by 
the <var!abIe |!st>. Unlike the INPUT statement, no question 
mark is printed with INPUT# statement. 

The data items In the file should appear just as they would if 
data were being typed In response to an INPUT statement. With 
numeric values, leading spaces, carriage returns, and line feeds 
are ignored. The first character encountered that is not a space, 
carriage return, or line feed Is assumed to be start of a number. 
The number terminates on a space, carriage return, line feed, 
or comma. 

Also, If the BASIC Is scanning the data for 3; string Item, leading 
spaces, carriage returns and line feeds are Ignored. The first 
character encountered that Is not a space, carriage return, or 
line feed Is assumed to be the start of a string item. If this 
first character Is a double-quotation mark (”), the string Item 
will consist of all characters read between the first quotation 
mark and the second. Thus, a quoted string may not contain a 




Language specification for MSX BASIC 


Page 55 


quotation mark as a character. 

If the first character of the string is not a quotation mark, 
the string is an unquoted string, and will terminate on a comma, 
carriage return, line feed, or after 255 characters have been 
read. If end of file Is reached when a numeric or string item 
is being INPUT, the item is terminated. 

LINE INPUT #< f iie number>,<string variable> 

; To read an entire line (up to 254 characters), without delimiters, 
from a sequential file to a string variable. 

< fI Ie number> is the number which the file was OPENed. 

<string variable> is the name of a string variable to which the 
line will be assigned. 

LINE INPUT# reads all characters in the sequential file up to 

a carriage return. It then skips over the carriage return/line 
feed sequence, and the next LINE INPUT# reads alI characters 
up to the next carriage return. (If a line feed/carriage return 
sequence is encountered, it is preserved. That is, the Iine 

feed/carriage return characters are returned as part of the 
string.) 

LINE INPUT# is espec i a I I y usefu I if each line of a file has been 

broken into fields, or if a BASIC program saved in ASCII mode 

is being read as data by another program. 

INPUTS(n,[#]<fI Ie number>) 

; To Return a string of n characters, read from the file. <file 
number> is the number which the file was OPENed. 

CLOSE [[#J<file number>C,<fiIe number>3D 

; To close the channel and releases the buffer associated with 

it. If no <fiIe number>'s are specified, ail open channels are 
cIosed. 

SAVE "<device descriptor>C < fiIe name>n" 

; To save a BASIC program file to the device. Control-Z is treated 
as end-of-file. 

LOAD "<device_descriptor>C < fiIe name>D" 

; To load a BASIC program file from the device. 

LOAD closes all open files and deletes the current program from 
memory. However, with the "R" option, all data files remain 
OPEN and execute the loaded program. 

If the <fI Ie name> Is omitted, the next program, which should 
be an ASCII file, encountered on the tape is loaded. Control-Z 
is treated as end-of-file. 

MERGE "<device descr I ptor >C< f I I e name>3" 

; To merge the lines from an ASCII program file into the program 
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currently in memory. 

If any lines in the file being merged have the same line number 
as lines in the program In memory, the lines from the file will 
replace the correspond Ing lines In memory. 

After the MERGE command, the MERGEd program resides In memory, 
and BASIC returns to command level. 

If the < f FIe name> is omitted, the next program files, it should 
be ASCII file, file encountered on the tape Is MERGEd. Control-Z 
is treated as end-of-file. 

BSAVE "<device descriptor>C<fi I e name>3",<top adrs>,<end adrs> 

C,<execution adrs>] 

; To save a memory image at the specified memory location to the 
device. (Currently, only CAS: Is supported.) 

<top adrs> and <end adrs> are the top address and the end address- 
of the area to be saved. 

If <execution adrs> is omitted, <top adrs> is regarded as 

<execution adrs>. 

Example: ' . 

BSAVE "CAS:TEST",&HA000,&HAFFF 
BSAVE "CAS:GAME",&HE000,&HE0FF,&HE020 

BLOAD "<dev i ce_descr I ptor >C< f i I e name>I]"II» RjC> < of f set>3 

; To load a machine language program from the specified device. 
(Currently only CAS: Is supported.) 

If R option is specified, after the loading, program begins 
execution automatically from the address which is specified at 
BSAVE. 

The loaded machine language program will be stored at the memory 
location which is specified at BSAVE. If <offset> is specified, 
all addresses which are specified at BSAVE are o.ffset by that 
vaIue. 

If the <fI Ie name> is omitted, the next machine language program 
file encountered Is loaded. 

CSAVE "<f!le name>"C,<baud rate>3 

; To save a BASIC program file to the cassette tape. 

BASIC saves the file In a compressed binary (tokenized) format. 
ASCII files take up more space, but some types of access require 
that files be In ASCII format. For example, a file intended 
to be MERGEd must be saved in ASCII format. Programs saved In 
ASCII may be read as BASIC data files and text files. In that 
case, use the SAVE command. 
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<baud ra+e> is a parameter from 1 to 2, which determines the 
default baud rate for every cassette write operations. 1 for 
1200 baud, 2 for 2400 baud. The default baud rate can also be 
set with SCREEN statement. 

CLOAD ["<f I I e name> 11 ] 

; To load a BASIC program file from the CMT. 

CLOAD closes all open files and deletes the current program from 
memory. If the <fiIe name> is omitted, the next program file 
encountered on the tape is loaded. For al I cassette read 
operations, baud rate is determined automatically. 

CLOAD? C«<fI Ie name>"H 

; To verify a BASIC program on CMT with one in memory. 

CALL <name of expanded statement>C( "^argument f I st > > U 

; To Invoke an expanded statement supplled by ROM cartridge. See 
SLOT.MEM for further details. is an abbreviation for 'CALL', 

so the next 2 statements have the same meaning. 


CALL TALK("Yamashita","HayashI ","Suzuki GSX400FW”) 
_TALK("Yamashita", "Hayashi"," Suzuki GSX400FW") 
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2.2.2 FunctIons 

BI N $ (<expression>) 

; Returns a binary equivalent string of <expression>. Leading 

0's are suppressed. 

POINT(<X coordinate>,<Y coordinated 

; Returns color of a specified pixel. 

VPEEK(<address of VRAM>) 

; Returns a value of VRAM specified. <address of VRAM> can be 
in the range of 0 .. 1 6383 . 

ST ICK(< n >) 

; Returns the direction of a joy-stick. <n> can be In the range 

of 0..2. If <n>=0, the cursor key is used as a joy-stick. If 

<n> is either 1 or 2, the joy-stick connected to proper port 

is used. When neutral, 0 is returned. Otherwise, value 
corresponding to direction is returned. 

1 

5 I 2 
\ I / 

\|/ 

7 - 0 - 3 

/ i \ 

/ I \ 

6 | 4 

STRIG(<n > ) 

; Returns the status of a trigger button of a joy-stick. <n> can 
be In the range of 0..4. If <n>=0, the space bar is used for 
a trigger button. if <n> is either 1 or 3, the trigger of a 
joy-stick 1 is used. When <n> is either 2 or 4, joy-stick 2. 
0 is returned if the trigger Is not being pressed, -1 is returned 
otherw I se. 

POL(< n > ) 

; Returns the value of a paddle. <n> can be in the range of 1..12. 
When <n> is either 1, 3, 5, 7, 9 or 11, the paddle connected 

to port 1 is used. When 2, 4, 6, 8, 10 or 12, the paddle 

connected to port 2 is used. 

PAD(< n >) 

; Returns various status of touch pad. <n> cqn be In the range 
of 0..7 . 

When 0..3 is specified, touch pad connected to Joy stick port 
1 Is selected, when 4..7, port 2. 

When <n>=0 or 4, the status of touch pad is returned, -1 when 
touched, 0 when released. 
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When <n>=! or 5, the X-coordlnate is returned, when <n>=2 or 

6, Y-coordtnate Is returned. 

When <n>=3 or 7, the status of switch on the pad Is returned, 
-1 when being pushed, 0 otherwise. 

Note that coordinates are valid only when PAD(O) (or PAD(4)) 
Is evaluated. When PAD(O) is evaluated, PAD(5) and PAD(6) are 
both affected, and when PAD(4), PAD(1) and PAD(2) . 

PLAY(<play chann&l>) 

; Returns the status of a music queue. <n> can be In the range 

of 0. . 3. If <n>=0, all 3 status are ORed and returned. If <n> 

Is either 1,2 or 3, -1 Is returned If the queue is still in 

operation, I.e., still playing. 0 is returned otherwise. 

EOF(<fI Ie_number>) 

; Returns -1 if end-of-file is encountered from input device. 
Otherwise, returns 0 


J 
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2.2.3 Special variables 

Following are the specfal variables for MSX. When assigned, the content 
is changed, when evaluated, the current value is returned. 

TIME (type: unsigned integer) 

; The system internal timer. TIME is automatically incremented 

by 1 everytime VDP generates interrupt (60 times per second), 
thus, when an interrupt is disabled (for example, when 

manipulating cassette). It retains the old value. 

SPRITEJ(<pattern number>) (type: string) 

; The pattern of sprite. 

<pattern number> must be less than 256 when size of sprites Is 
0 or 1, less than 64 when size of sprites is 2 or 3. 

The length of this variable Is fixed to 32 (bytes). So, if assign 
the string that is shorter than 32 character, the chr$(0)s are 
added. 

Exam p I e 
I i st 

100 SCREEN 3,3 

110 AS=CHR5(1)+CHRS(3)+CHRS(7)+CHRS(&HF)+CHRS(&H1F) 

+ CHRS(&H3F)+CHR S(&H7 F)+CHRS(&HFF) 

120 SPRITES(1)=A$ 

130 SPRITES(2)=AS+AS 
140 SPRITE$(3)=A$+A$+A$ 

150 SPRITE5(4)=A5+AS+AS+AS 
160 PUT SPRITE 1 ,(20,20 ), 1 5 
170 PUT SPRITE 2 ,(60.20), 1 5 
180 PUT SPRITE 3,( 100,20 ), 1 5 
1 90 PUT SPRITE 4 ,(140,20 ) , 15 
200 GOTO 200 
0k 
run 

************************************************************************* 

* 

* Note: Following two are system variables which can be evaluated 

* or assigned like other ordinary variables. Prepared for 

* advanced programmers only. If you don’t know the meaning, 

* never use. 

* 

#**#***********#****###****########****#*#*#***#**************##********* 

VDP(<n>) (type: unsigned byte) 

; If <n> Is In the range o.f 0..7, specifies the current value of 
VDP's write only register. 'If <n> Is 8, specifies the status 
register of VDP. VDP(8) Is read only. 

BASE(<n>) (type: Integer) 

; Current base address for each table. The description of <n> 
foI lows next. 
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0 

1 

2 

3 

4 


base of name 
meaningI ess 
base of pattern 
meaningI ess 
meaningI ess 


table for text mode. 


generator table for 


\ 

text mode. > 40 * 24 

/ 

/ ' 


5 

6 

7 

8 
9 


base of name table for text mode. ' 

base of color tabie for text mode. V 

base of pattern generator table for text mode. > 32 * 24 

base of sprite attribute table for text mode. / 

base of sprite pattern table for text mode. / 


10 
1 1 
1 2 
13 
1 4 


base of name table for high-resoIutI on mode. 

base of color table for high-resoIution mode. 

base of pattern generator table for high-resolution mode. 

base of sprite attribute table for high-resolution mode. 

base of sprite pattern tabie for high-resolution mode. 


15 

16 
17 
1 8 
1 9 


base of name table for multi-color mode, 
meaningI ess 

base of pattern generator table for multi-color mode, 
base of sprite attribute table for multi-color mode, 
base of sprite pattern table for multi-color mode. 
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CHAPTER 3 
APPEND I X 


A. Summary of error codes and error messages 


code message 

1 NEXT without FOR 

A varfable In a NEXT statement does not 
correspond to any previously executed, unmatched 
FOR statement variable. 

2 Syntax error 

A line is encountered that contains some 
incorrect sequence of characters (such as 
unmatched parenthesis, misspelled command or 
statement, incorrect punctuation, etc.) 

3 RETURN without GOSUB 

A RETURN statement is encountered for which 
there is no previous, unmatched GOSUB statement. 

4 Out of DATA 

A READ statement is executed when there are 
no DATA statement with unread data remaining 
in the program. 

5 Illegal function call 

A parameter that Is out of the range Is passed 
to a math or string function. An FC error 
may also occur as the result of: 

1. a negative or unreasonably large subscript. 

2. a negative or zero argument with LOG. 

3. a negative argument to SQR. 

4. an Improper argument to MID$, LEFTS, RIGHTS, 
INP, OUT, PEEK, POKE, TAB, SPC, STRINGS, 
SPACES, INSTRS or ON...GOTO. 

6 Overflow 

The result of a calculation Is too large to 
be represented In 'BASIC's number format. 

7 Out of memory 

A program Is too large, has too many files, 
has too many FOR loops or G0SU8s, too many 
variables, or expressions that are too 
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com piicated. 

8 Undefined line number 

A line reference In a GOTO, GOSUB, 
IF...THEN...ELSE is to a nonexistent line. 

9. Subscript out of range 

An array element Is referenced either with 
a subscript that Is outside the dimensions 
of the array, or with the wrong number of 
subscripts. 

10 Redimensioned array 

Two DIM statements are given for the same array, 
or DIM statement Is given for an array after 
the default dimension of 10 has been established 
for that array. 

11 Division by zero 

A division by zero is encountered in an 
expression, or the operation of involution 
results In zero being raised to a negative 
power. 

12 Illegal direct 

A statement that is illegal in direct mode 
is entered as a direct mode command. 

13 Type mismatch 

A string variable name is assigned a numeric 
value or vice versa; a function that expects 
a numeric argument is given a string argument 
or vice versa. 

14 Out of string space 

String variables have caused BASIC to exceed 
the amount of free memory remaining. BASIC 
will allocate string space dynamically, until 
it runs out of memory. 

15 String too long 

An attempt is made to create a string more 
than 255 character long. 

16 String formula too complex 

A string expression is too long or too complex. 
The expression should be broken into smaller 
express ions. 

17 Can't contlnue 

An attempt is made to continue a program that: 

1. has halted due to an error, 

2. has been modified during a break in 
execution, or 
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1 9 


20 
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21 


22 


23 


24 


25 

26 

49 

50 


51 


52 


3. does not exist. 

Undefined user function 

FN function is called before defining it with 
the DEF FN statement. 

Device i/0 error 

An I/O error occurred on a cassette, printer, 
or CRT operation. It Is a fatal error; I.e., 
BASIC cannot recover from the error. 

Verify error 

The current program is different from the 

program saved on the cassette. 

No RESUME 

An error trapping routine is entered but 

contains no RESUME statement. 

RESUME without error 

A RESUME statement Is encountered before an 
error trapping routine is entered. 

Unprintable error 

An error message Is not available for the error 
condition which exists. This is usually caused 
by an ERROR with an undefined error code. 

Missing operand 

An expression, contained an operator with no 
operand following it. 

Line buffer overflow 

An entered line has too many characters. 
Unprintable errors 

These codes have no definitions. Should be 
reserved for future expansion in BASIC. 

FIELD overf low __ 

A FIELD statement Is attempting allocate more 
bytes than were specified for the record length 
of a random file in the OPEN statement. Or, 
the end of the FIELD buffer is encountered 
while doing sequential I/0(PR I NT#, INPUT#) to 
a random file. 

I nternaI error 

An internal malfunction has occurred. Report 
to Microsoft the conditions under which the 
message appeared. 

Bad file number 

A statement or command references a file with 
a file number that is not .OPEN or Is out of 
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56 


the range of file numbers specified by MAXFILE 
statement. 

File not found 

A LOAD, KILL, or OPEN statement references 
a file that does not exist in the memory. 

File already open 

A sequential output mode OPEN Is issued for 
a file that Is already open; or a KILL Is given 
for a file that is open. 

I nput past end 

An INPUT statement Is executed after all the 
data in the file has been INPUT, or for null 
(empty) file. To avoid this error, use the 
EOF function to detect the end of file. 

Bad file name 

An Illegal form is used for the file name with 
LOAD, SAVE, KILL, NAME, etc. 


57 Direct statement in file 

A direct statement is encountered while LOADIng 
an ASCII format file. The LOAD is terminated. 

58 Sequential I/O only 

A statement to random access is issued for 
a sequential file. 

59 File not OPEN • 

The file specified In a PRINT#, INPUT#, etc. 



hasn't been 

OPENed. 


60 

Unprintab1e error 



# 

. These codes 

have no definitions. Users 

may 

• 

p1 ace their 

own error code definitions at 

the 

255 

high end of 

this range. 







